Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/DNSTaskService.md
+++ b/文档/DNSTaskService.md
@@ -0,0 +1,141 @@
+# DNSTaskService
+> DNS同步相关任务
+
+---
+
+## deleteAllDNSTasks
+> 删除所有同步任务
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/DNSTaskService/deleteAllDNSTasks`
+- RPC：`rpc deleteAllDNSTasks(DeleteAllDNSTasksRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteAllDNSTasksRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/DNSTaskService/deleteAllDNSTasks" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## deleteDNSTask
+> 删除任务
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/DNSTaskService/deleteDNSTask`
+- RPC：`rpc deleteDNSTask (DeleteDNSTaskRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteDNSTaskRequest`)**
+
+```json
+{
+  "dnsTaskId": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/DNSTaskService/deleteDNSTask" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## existsDNSTasks
+> 检查是否有正在执行的任务
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/DNSTaskService/existsDNSTasks`
+- RPC：`rpc existsDNSTasks (ExistsDNSTasksRequest) returns (ExistsDNSTasksResponse);`
+
+**请求对象 (`ExistsDNSTasksRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`ExistsDNSTasksResponse`)**
+
+```json
+{
+  "existTasks": "bool",
+  "existError": "bool"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/DNSTaskService/existsDNSTasks" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllDoingDNSTasks
+> 查找正在执行的所有任务
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/DNSTaskService/findAllDoingDNSTasks`
+- RPC：`rpc findAllDoingDNSTasks (FindAllDoingDNSTasksRequest) returns (FindAllDoingDNSTasksResponse);`
+
+**请求对象 (`FindAllDoingDNSTasksRequest`)**
+
+```json
+{
+  "nodeClusterId": "int64 // 集群ID"
+}
+```
+
+**响应对象 (`FindAllDoingDNSTasksResponse`)**
+
+```json
+{
+  "dnsTasks": "[]DNSTask"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/DNSTaskService/findAllDoingDNSTasks" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---