145 lines
3.8 KiB
Plaintext
145 lines
3.8 KiB
Plaintext
---
|
|
description: cloudflare相关的说明
|
|
globs:
|
|
alwaysApply: false
|
|
---
|
|
|
|
# Cloudflare 域管理及DNS管理功能
|
|
- cloudflare的统一返回结构体为
|
|
{
|
|
"result": any,
|
|
"result_info": {
|
|
"page": 1,
|
|
"per_page": 20,
|
|
"total_pages": 1,
|
|
"count": 1,
|
|
"total_count": 1
|
|
},
|
|
"success": true,
|
|
"errors": [
|
|
{
|
|
"code": 6003,
|
|
"message": "Invalid request headers",
|
|
"error_chain": [
|
|
{
|
|
"code": 6111,
|
|
"message": "Invalid format for Authorization header"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"messages": []
|
|
}
|
|
|
|
|
|
## domain管理功能
|
|
|
|
### domain的查询功能
|
|
- 返回结构体如下
|
|
{
|
|
"result": [
|
|
{
|
|
"id": "511894a4f1357feb905e974e16241ebb",
|
|
"name": "107421.xyz",
|
|
"status": "active",
|
|
"paused": false,
|
|
"type": "full",
|
|
"development_mode": 0,
|
|
"name_servers": [
|
|
"ali.ns.cloudflare.com",
|
|
"walt.ns.cloudflare.com"
|
|
],
|
|
"original_name_servers": [
|
|
"ns1.dnsowl.com",
|
|
"ns2.dnsowl.com",
|
|
"ns3.dnsowl.com"
|
|
],
|
|
"original_registrar": null,
|
|
"original_dnshost": null,
|
|
"modified_on": "2021-11-03T01:47:42.506130Z",
|
|
"created_on": "2021-11-03T01:33:07.447056Z",
|
|
"activated_on": "2021-11-03T01:47:42.506130Z",
|
|
"meta": {
|
|
"step": 2,
|
|
"custom_certificate_quota": 0,
|
|
"page_rule_quota": 3,
|
|
"phishing_detected": false
|
|
},
|
|
"owner": {
|
|
"id": null,
|
|
"type": "user",
|
|
"email": null
|
|
},
|
|
"account": {
|
|
"id": "dfaadeb83406ef5ad35da02617af9191",
|
|
"name": "Zeaslity@gmail.com's Account"
|
|
},
|
|
"tenant": {
|
|
"id": null,
|
|
"name": null
|
|
},
|
|
"tenant_unit": {
|
|
"id": null
|
|
},
|
|
"permissions": [
|
|
"#zone:read",
|
|
"#zone_settings:read",
|
|
"#dns_records:edit",
|
|
"#dns_records:read"
|
|
],
|
|
"plan": {
|
|
"id": "0feeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
|
|
"name": "Free Website",
|
|
"price": 0,
|
|
"currency": "USD",
|
|
"frequency": "",
|
|
"is_subscribed": false,
|
|
"can_subscribe": false,
|
|
"legacy_id": "free",
|
|
"legacy_discount": false,
|
|
"externally_managed": false
|
|
}
|
|
}
|
|
],
|
|
"result_info": {
|
|
"page": 1,
|
|
"per_page": 20,
|
|
"total_pages": 1,
|
|
"count": 1,
|
|
"total_count": 1
|
|
},
|
|
"success": true,
|
|
"errors": [],
|
|
"messages": []
|
|
}
|
|
|
|
|
|
## DNS管理功能实现
|
|
- 需要实现特定domain的DNS的管理
|
|
- 参考文档 https://developers.cloudflare.com/api/resources/dns/subresources/records/
|
|
|
|
### 查询全部DNS记录
|
|
- 单条DNS记录的结构体如下 {
|
|
"id": "b940757dfd94e8e2941e2ec1b2ee0515",
|
|
"name": "mail.107421.xyz",
|
|
"type": "MX",
|
|
"content": "mx2.yuanyoupush.com",
|
|
"priority": 20,
|
|
"proxiable": false,
|
|
"proxied": false,
|
|
"ttl": 1,
|
|
"settings": {},
|
|
"meta": {},
|
|
"comment": "全自动邮箱",
|
|
"tags": [],
|
|
"created_on": "2025-03-15T05:56:37.296599Z",
|
|
"modified_on": "2025-03-15T05:57:08.180765Z",
|
|
"comment_modified_on": "2025-03-15T05:56:37.296599Z"
|
|
},
|
|
|
|
### 更新某个DNS记录
|
|
|
|
### 删除某个DNS记录
|
|
|
|
### 新增一个DNS记录
|