DNSPod
旗下子品牌
API Documents
Cancel
Contents
Get Record List
1. API Description
This API (Record.List) is used to get record list.
Domain name for API request:https://api.dnspod.com/Record.List
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. |
offset | no | The offset of the response.The first one is numbered as 0.Optional parameter. |
length | no | The number of response result.Optional parameter. |
sub_domain | no | If the subsidiary domain is set,only the information about it will be responded. |
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 |
---|---|
-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 | Invalid offset. |
8 | Invalid length. |
9 | You don’t have the permission. |
10 | Empty result. |
Attention:
If there are more than 500 records,only the first 500 will be responded.You may need to set “offset” and “length” to get all the records with requests.
4. Sample
curl -X POST https://api.dnspod.com/Record.List -d 'login_token=730060,e1a8a$f14dc5dcbafd83680b3d2a553c4d553d&format=json&domain_id=2317346'
The following is a sample response:
- JSON:
{
"status": {
"code": "1",
"message": "Action completed successful",
"created_at": "2014-06-05 09:58:40"
},
"domain": {
"id": "9",
"name": "dnspod.com",
"punycode": "dnspod.com",
"grade": "DP_Free",
"owner": "yizerowu@dnspod.com"
},
"info": {
"sub_domains": "5",
"record_total": "5"
},
"records": [
{
"id": "50",
"name": "@",
"line": "Default",
"type": "A",
"ttl": "600",
"value": "96.126.115.73",
"mx": "0",
"enabled": "1",
"status": "enabled",
"monitor_status": "",
"remark": "",
"updated_on": "2014-06-05 09:47:59"
},
{
"id": "49",
"name": "@",
"line": "Default",
"type": "MX",
"ttl": "600",
"value": "cloudmx.qq.com.",
"mx": "5",
"enabled": "1",
"status": "enabled",
"monitor_status": "",
"remark": "",
"updated_on": "2014-06-05 09:47:59"
},
{
"id": "46",
"name": "@",
"line": "Default",
"type": "NS",
"ttl": "600",
"value": "a.dnspod.com.",
"mx": "0",
"enabled": "1",
"status": "enabled",
"monitor_status": "",
"remark": "",
"updated_on": "2014-06-05 09:47:40",
"hold": "hold"
},
{
"id": "47",
"name": "@",
"line": "Default",
"type": "NS",
"ttl": "600",
"value": "b.dnspod.com.",
"mx": "0",
"enabled": "1",
"status": "enabled",
"monitor_status": "",
"remark": "",
"updated_on": "2014-06-05 09:47:40",
"hold": "hold"
},
{
"id": "48",
"name": "@",
"line": "Default",
"type": "NS",
"ttl": "600",
"value": "c.dnspod.com.",
"mx": "0",
"enabled": "1",
"status": "enabled",
"monitor_status": "",
"remark": "",
"updated_on": "2014-06-05 09:47:40",
"hold": "hold"
}
]
}
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