API documentation POST /shortlinks
Create new shortlinks
POST https://demo.trafficmanager.com/api/v1/shortlinks
Authentication:
You have two options:
1. Pass the uid as a POST parameters.
2. Authentication with the following HTTP headers:
GET Parameters:
- none
POST Parameters:
Always required:
-
offers: one or more offer IDs.
Multiple comma-separated values are allowed, e.g.offers=45,46,47
Optional:
subidsubid2subid3subid4pubidutm_sourceutm_mediumutm_campaignutm_termutm_contentdomain: domain to use for the shortlink. e.g.affiliate-domain.comlinks_number: number of shortlinks to generate for each offer. Default=1-
suffix: custom suffix for the shortlink. e.g.abcde, resulting shortlink will behttps://affiliate-domain.com/abcde.
This parameter is incompatible with thelinks_numberparameter. user_id: the user for which the shortlinks will be generated
Response codes:
200: The shortlinks are generated successfully.400: Invalid request. One or more required fields are missing.403: Authentication failed.
Returned values:
code: see Response codes aboveoffer_idshortlink
Request example
curl --location --request POST 'https://demo.trafficmanager.com/api/v1/shortlinks' \ --header 'x-user-id: 04120c02-0000-439f-9f0a-66624e66fc00' \ --header 'x-api-key: TM04dca746122da971e06665d496ebc450' \ --form 'offers=45' \ --form 'links_number=3' \ --form 'domain=affiliate-domain.com' \ --form 'subid=value1' \ --form 'subid2=value2' \ --form 'subid3=value3' \ --form 'subid4=value4' \ --form 'pubid=value5' \ --form 'utm_source=value6' \ --form 'utm_medium=value7' \ --form 'utm_campaign=value8' \ --form 'utm_term=value9' \ --form 'user_id=5' \ --form 'utm_content=value10'
Response example
Success:
[
{
"offer_id": "45",
"shortlink": "https://affiliate-domain.com/5X4p2P",
"user_id": "5"
},
{
"offer_id": "45",
"shortlink": "https://affiliate-domain.com/0YSf6a",
"user_id": "5"
},
{
"offer_id": "45",
"shortlink": "https://affiliate-domain.com/26faux",
"user_id": "5"
}
]
English
العربية
Dansk
Español
Suomi
Italiano
Português
Română
Русский
Svenska
中文