- 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 \ List all Shorturls
Send a GET request to the following resource to retrieve the shortened urls for one of your Sites.
| 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.<format> to obtain the list of existing shorturls.
2. Result: the code returned by the API
The API will return the list of shortened urls. Each entry contains a <shorturl_token>
that uniquely identifies the shortened url. Use this token to obtain more details
about an url.
Example for a list containing two shortened urls:
{
"response": {
"request": {
"date": "Fri, 16 Sep 2011 15:43:39 0200",
"resource": "/shorturls.json",
"status": {
"flag": "success",
"code": 200
}
},
"result": {
"data": {
"shorturls": {
"count": 2,
"entries": [
{
"shorturl_token": "NoFSx",
"original_url": "http://www.oneall.com",
"short_url": "http://oal.lu/NoFSx",
"date_creation": "Thu, 15 Sep 2011 11:00:56 0200",
"num_referrals": 0
},
{
"shorturl_token": "dam3Y",
"original_url": "http://www.oneall.com/services/",
"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": 10
}
]
}
}
}
}
}
Example for a list containing no shortened urls:
{
"response": {
"request": {
"date": "Fri, 11 Sep 2011 15:43:39 0200",
"resource": "/shorturls.json",
"status": {
"flag": "success",
"code": 200
}
},
"result": {
"data": {
"shorturls": {
"count": 0
}
}
}
}
}