Get DynamicURL

Description

Returns the DynamicURL of a given record part from the Dynamic DNS service.

Note: This function is available only for A and AAAA record types. Тhe DynamicURL is disabled this method will enable it and will return the URL


 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 The name of the domain the record belongs to.
record-id Integer Required The ID of the record you want to get the DynamicURL of. You can get the record with List records.

Returns: Array with the host and the DynamicURL.


Errors

When the authenctication 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."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

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

When invalid or non-existant domain-name is entered, the following status will be returned:

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

If incorrect value is entered for record-id, the following status will be returned:.

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

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/dns/get-dynamic-url.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813

URL XML: https://api.cloudns.net/dns/get-dynamic-url.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813


Last modified: 2019-06-30
Mit dem Betreten und Verwenden dieser Webseite erklären Sie sich damit einverstanden, dass die Webseite cloudns.net und alle dazugehörigen Subdomains Cookies verwenden. Das ist nötig, um ein optimales Nutzererlebnis zu gewährleisten. Erfahren Sie mehr