- Basic Information Terminology, getting started and setting up your account. Recommended for new customers.
- Make your website social Step-by-step tutorials and information on how to integrate our plugins and services to your site.
- REST API Reference JSON/REST API for advanced social network integration. Must-read for developers.
Shorturl API \ Read Shorturl details
Send a GET request to the following resource to retrieve the details of an existing Shorturl.
| Resource/URI | GET | POST | PUT | DELETE |
Shorturls
/shorturls.<format>
|
List all Shorturls | Create a new Shorturl | – | – |
Shorturl
/shorturls/<shorturl_token>.<format>
|
Read details of a Shorturl | – | – | Delete a Shorturl |
Workflow
1. Request: the code to send to the API
Send a GET request to the resource /shorturls/<shorturl_token>.<format> to obtain the details
of a previously created shorturl.
2. Result: the code returned by the API
The API will return the shorturl details including the list of click-throughs/referrals obtained through the shortened url.
{
"response": {
"request": {
"date": "Fri, 16 Sep 2011 17:42:02 0200",
"resource": "/shorturls/dam3Y.json",
"status": {
"flag": "success",
"code": 200,
"info": "Your request has been processed successfully"
}
},
"result": {
"data": {
"shorturl": {
"shorturl_token": "dam3Y",
"original_url": "http://www.oneall.com",
"short_url": "http://oal.lu/dam3Y",
"date_creation": "Thu, 15 Sep 2011 11:27:27 0200",
"date_last_referral": "Fri, 16 Sep 2011 07:24:36 0200",
"num_referrals": 2,
"referrals": {
"count": 2,
"entries": [
{
"page": "http://www.facebook.com/",
"ip_address": "123.123.123.123",
"date_creation": "Fri, 16 Sep 2011 01:07:51 0200"
},
{
"page": "http://www.example.com",
"ip_address": "222.333.444.555",
"date_creation": "Fri, 16 Sep 2011 02:08:07 0200"
}
]
}
}
}
}
}
}