Case Study - Defending against DDoS attacks, improving DNS management, and enhancing web redirects

Get Dynamic URL history

Description

Get Dynamic URL history of a record


 Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Domain name containing the record
record-id String Required Record ID. You can see this ID with the method List records 
rows-per-page Integer  Required Results per page. Can be 10, 20, 30, 50, or 100. 
page Integer  Required Page number starting from 1.

Return: Status and description if there is an error. Dynamic URL history of a record if everything is correct.


Errors

When the authentication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If you have entered an invalid or non-existent domain name, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

If the entered Record ID is invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid record-id param."}

If there is no added value for "rows-per-page", the following status will be returned:

{"status":"Failed","statusDescription":"Wrong or missing required parameter 'rows-per-page'."}

If there is no added value for "page", the following status will be returned:

{"status":"Failed","statusDescription":"Wrong or missing required parameter 'page'."}

Note: These are example errors in JSON format, and these are not the only errors that can be displayed

 Example

URL JSON: https://api.cloudns.net/dns/get-dynamic-url-history.json
POST/GET: auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1
POST/GET: sub-auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1

URL XML: https://api.cloudns.net/dns/get-dynamic-url-history.xml
POST/GET: auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1
POST/GET: sub-auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1


Last modified: 2023-10-24
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more