API
Commands
Note: required parameters are marked with blue.
Create campaign / Update campaign
https://api.riblink.ru/en/request/json/campaigns/createIf no campaign_id is specified, then a new campaign will be created. If campaign_id is specified, updates the campaign data. Returns campaign data that was created/updated
Parameters:
- title - Campaign name
- campaign_id - Campaign ID if you want to update the data of a previously created campaign
- links_type - Links type: 0 - key only (default), 1 - key and URL part
- ads_type - Ads type: 0 - no ads, 1 - loading page (default)
- ads_popunder - Enable popunder/clickunder (default is OFF)
- ads_adult - Allow adult ads (default is ON)
- ads_interval - Ads frequency (sec.): 0 - no limits (default), 3600 - once per hour, 86400 - once per day
- show_dest_url - Show the destination URL to the client (default is ON)
- links_title - Title for all links
- links_description - Description
- links_button - Button caption
- public_stat - Public statistics on the links
- password - URL password
- password_confirm - Confirm password
- domain_id - The domain ID you previously connected. All campaign links will use this domain
Response example:
{ "result": true, "data": { "id": 521, "title": "My new campaign", "type": "manual", "status": "active", "ads_type": 0, "ads_popunder": 1, "ads_adult": 0, "ads_interval": 0, "links_type": 0, "show_dest_url": 0, "links_title": "", "links_description": "", "links_button": "", "has_links_password": true, "domain": "https://rib.ink", "public_stat": 0, "urls_amount": 0, "created": "2017-09-15 20:38:54" } }
Get campaign data
https://api.riblink.ru/en/request/json/campaigns/getParameters:
- campaign_id - Campaign ID
Response example:
{ "result": true, "data": { "id": 521, "title": "My new campaign", "type": "manual", "status": "active", "ads_type": 0, "ads_popunder": 1, "ads_adult": 0, "ads_interval": 0, "links_type": 0, "show_dest_url": 0, "links_title": "", "links_description": "", "links_button": "", "has_links_password": true, "domain": "https://rib.ink", "public_stat": 0, "urls_amount": 0, "created": "2017-09-15 20:38:54" } }
Create link / Update link
https://api.riblink.ru/en/request/json/campaigns/links/createIf no link_id is specified, then a new link will be created. If link_id is specified, updates the existing link data. Returns link data that was created/updated
Parameters:
- url - URL to be converted
- link_id - Link ID if you want to update an existing link
- campaign_id - Campaign ID to which the link will be added (only when creating a new link). If not specified - the link will be added to the default campaign
- url_key - The key of the link (part the short link ends with). If not specified, random will be created
- title - Link title
- description - Link description
- button - Button caption
- comment - Add notes to the URL (only you can see it)
Response example:
{ "result": true }
Get link data
https://api.riblink.ru/en/request/json/campaigns/links/getFinds the link by link_id or url_key and returns its data. Shows the data only for your own links.
Parameters:
- link_id - Link ID
- url_key - The key of the link (part the short link ends with)
Response example:
{ "result": true, "data": { "id": 36523, "campaign_id": 521, "campaign_title": "My new campaign", "url_key": "bx5i", "url": "https://riblink.ru/index/rules", "title": "", "description": "", "button": "", "comment": "", "created": "2017-09-16 13:23:24" } }