DNSPod
旗下子品牌
API Documents
Cancel
Contents
Update the Dynamic DNS Record
1. API Description
This API (Record.Ddns) is used to update the dynamic DNS rcord.
Domain name for API request:https://api.dnspod.com/Record.Ddns
HTTP request method: POST
2. Request Parameters
The table below lists only the API request parameters. Common request parameters are required when the API is called. For more information, please see Common Request Parameters.
Parameter | Required | Description |
---|---|---|
domain_id | yes | The domain id. Mandatory parameter. |
record_id | yes | The record id. Mandatory parameter. |
sub_domain | no | The record name like “www”. |
record_line | yes | The record line.You can get the list from the API.The default value is “default”, such as “default”, “AD”, “AE”. Mandatory parameter. |
value | yes | The IP address like “6.6.6.6”.Optional parameter. |
3. Response Codes
Only the response codes related to this API are listed below. For other response codes, please see Common Return Codes.
Response Code | Description |
---|---|
-15 | Domain got prohibited. |
-7 | A domain of a company account need a upgrade first. |
-8 | You need a upgrade for the domain you are acting for. |
6 | Invalid domain id.。 |
7 | You don’t have the permission. |
8 | Invalid record id. |
21 | Domain got locked. |
22 | Invalid sub domain. |
23 | The number of the record level is up to limit. |
24 | Invalid sub domain for general analysis.。 |
25 | The number of poll is up to limit. |
26 | Invalid record line. |
4. Sample
curl -X POST https://api.dnspod.com/Record.Ddns -d 'login_token=730060,e1a8a$f14dc5dcbafd83680b3d2a553c4d553d&format=json&domain_id=2317346&record_id=16894439&record_line=default&sub_domain=www'
The following is a sample response:
- JSON:
{
"status": {
"code":"1",
"message":"Action completed successful",
"created_at":"2012-11-24 17:23:58"
},
"record": {
"id":16909160,
"name":"@",
"value":"111.111.111.111"
}
}
Last updated on 2022-03-11 02:59
Is the above content helpful to you?
Helpful
Unhelpful
Select an issue type
- Can't find what I need
- Update is not timely
- Difficult to understand
- Typo/invalid link
- Steps are incomplete
- Missing images/sample codes
View on Mobile Phone
Click to copy the link
DNS health check tool powered by DNSPod
查询域名信息,快速排查网站问题
Official WeChat group
Join WeChat group to chat and feedback
Scan using WeChat