# 全局公共参数 **全局Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **全局Query参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **全局Body参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **全局认证方式** > 无需认证 # 状态码说明 | 状态码 | 中文描述 | | --- | ---- | | 暂无参数 | # 用户侧 > 创建人: 吴培林 > 更新人: 吴培林 > 创建时间: 2025-08-02 08:59:42 > 更新时间: 2025-08-02 08:59:46 ```text 暂无描述 ``` **目录Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录Query参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录Body参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录认证信息** > 继承父级 **Query** ## 域名管理 > 创建人: 吴培林 > 更新人: 吴培林 > 创建时间: 2025-08-05 10:48:09 > 更新时间: 2025-08-07 14:51:09 ```text 暂无描述 ``` **目录Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录Query参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录Body参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | 暂无参数 | **目录认证信息** > 继承父级 **Query** ### 获取域名列表 > 创建人: 吴培林 > 更新人: chudong > 创建时间: 2025-08-07 16:12:06 > 更新时间: 2025-08-07 22:02:11 ```text 暂无描述 ``` **接口状态** > 已完成 **接口URL** > http://192.168.77.150:5000/api/v1/domain/manage/list **请求方式** > POST **Content-Type** > json **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **请求Body参数** ```javascript { } ``` **认证方式** > 继承父级 **响应示例** * 成功(200) ```javascript { "code": 0, "data": { "data": [ { "created_at": 1754358178, "dns_id": 0, "expire_time": 1755269100, "full_domain": "wzznnnnnb.top", "id": 1, "ns1": null, "ns2": null, "ns_status": 0, "real_name_status": 0, "real_name_template_id": 5, "register_time": 1754577905, "remark": "一个很牛逼的域名", "status": 1, "suffix": "top" } ], "page": "
1共1条数据
", "row": "10", "shift": "0" }, "msg": "域名列表获取成功", "status": true } ``` | 参数名 | 示例值 | 参数类型 | 参数描述 | | --- | --- | ---- | ---- | | code | 0 | number | - | | data | - | object | - | | data.expiring_domains | 0 | number | - | | data.expiring_domains_top10 | - | array | - | | data.pending_orders | 22 | number | - | | data.recent_orders | - | array | - | | data.recent_orders.cancel_reason | - | null | - | | data.recent_orders.cancel_time | - | null | - | | data.recent_orders.complete_time | - | null | - | | data.recent_orders.created_at | 1754548879 | number | - | | data.recent_orders.expire_time | Fri, 08 Aug 2025 14:41:19 GMT | string | - | | data.recent_orders.id | 23 | number | - | | data.recent_orders.is_main_order | 0 | number | - | | data.recent_orders.order_no | 202508071441191cf0811a | string | - | | data.recent_orders.order_type | 1 | number | - | | data.recent_orders.product_type | domain | string | - | | data.recent_orders.refund_reason | - | null | - | | data.recent_orders.refund_time | - | null | - | | data.recent_orders.source | website | string | - | | data.recent_orders.status | 0 | number | - | | data.recent_orders.total_amount | 1100.00 | string | - | | data.recent_orders.uid | 1111 | number | - | | data.recent_orders.updated_at | Thu, 07 Aug 2025 14:41:19 GMT | string | - | | data.total_domains | 0 | number | - | | msg | 用户后台首页统计获取成功 | string | - | | status | true | boolean | - | * 失败(404) ```javascript 暂无数据 ``` **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **Query** ### 获取指定域名详情 > 创建人: 吴培林 > 更新人: chudong > 创建时间: 2025-08-07 16:13:00 > 更新时间: 2025-08-07 22:02:22 ```text 暂无描述 ``` **接口状态** > 已完成 **接口URL** > http://192.168.77.150:5000/api/v1/domain/manage/detail **请求方式** > POST **Content-Type** > json **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **请求Body参数** ```javascript { "domain_id": 1 } ``` **认证方式** > 继承父级 **响应示例** * 成功(200) ```javascript { "code": 0, "data": { "dns_records": [ { "MX": 55, "TTL": 600, "created_at": 1754447506, "domainID": 195631306, "domain_id": 1, "record": "cc", "recordID": 607981664, "record_id": 2, "remark": "", "state": 0, "type": "CNAME", "uid": 1111, "value": "dns.bt.cn", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461608, "domainID": 195631306, "domain_id": 1, "record": "www", "recordID": 607989402, "record_id": 5, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461803, "domainID": 195631306, "domain_id": 1, "record": "www1", "recordID": 607989413, "record_id": 6, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461963, "domainID": 195631306, "domain_id": 1, "record": "www11", "recordID": 607989562, "record_id": 7, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461989, "domainID": 195631306, "domain_id": 1, "record": "www121", "recordID": 607989567, "record_id": 8, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754462055, "domainID": 195631306, "domain_id": 1, "record": "www1223231", "recordID": 607989574, "record_id": 9, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.2", "viewID": 0 } ], "domain_info": { "created_at": 1754358178, "dns_id": 0, "dns_lock": 0, "dns_state": 0, "dns_type": 1, "domainId": 195631306, "domain_name": "wzznnnnnb", "expire_time": 1755269100, "full_domain": "wzznnnnnb.top", "id": 1, "last_operator_id": null, "last_operator_type": 0, "ns1": null, "ns2": null, "ns_status": 0, "owner_name": null, "owner_name_en": null, "real_name_status": 0, "real_name_template_id": 5, "register_time": 1754577905, "registrar": null, "registrar_domain_id": null, "remark": "一个很牛逼的域名", "status": 1, "suffix": "top", "transfer_lock": 0, "uid": 1111, "update_lock": 0, "updated_at": 1754556472 }, "real_name_info": { "address": "南城区天安数码城F8栋106", "address_en": "Room 106, Unit 8, Building 6, Tian'an Cyber Park, No. 1 Huangjin Road, Nancheng Street, Dongguan City, Guangdong Province", "business_license": "", "city": "广东省-东莞市-南城区", "contact_person": "吴培林", "created_at": 1754386208, "email": "1245@qq.com", "fail_reason": "", "id": 5, "id_image_back": "f6b9e62a71b211f0be471a4b78c8f991.jpg", "id_image_front": "dbda296e71b211f090ae1a4b78c8f991.jpg", "id_number": "441581200012111213", "id_type": 1, "is_default": 0, "owner_name": "吴培林", "owner_name_en": "wupeilin", "phone": "15579151727", "postal_code": "523000", "registrant_id": "kinfoid54960", "status": 2, "template_name": "吴培林", "template_status": "approved", "type": 1, "uid": 1111, "updated_at": 1754386857, "verify_time": "Tue, 05 Aug 2025 17:40:57 GMT" } }, "msg": "域名详情获取成功", "status": true } ``` | 参数名 | 示例值 | 参数类型 | 参数描述 | | --- | --- | ---- | ---- | | code | 0 | number | - | | data | - | object | - | | data.expiring_domains | 0 | number | - | | data.expiring_domains_top10 | - | array | - | | data.pending_orders | 22 | number | - | | data.recent_orders | - | array | - | | data.recent_orders.cancel_reason | - | null | - | | data.recent_orders.cancel_time | - | null | - | | data.recent_orders.complete_time | - | null | - | | data.recent_orders.created_at | 1754548879 | number | - | | data.recent_orders.expire_time | Fri, 08 Aug 2025 14:41:19 GMT | string | - | | data.recent_orders.id | 23 | number | - | | data.recent_orders.is_main_order | 0 | number | - | | data.recent_orders.order_no | 202508071441191cf0811a | string | - | | data.recent_orders.order_type | 1 | number | - | | data.recent_orders.product_type | domain | string | - | | data.recent_orders.refund_reason | - | null | - | | data.recent_orders.refund_time | - | null | - | | data.recent_orders.source | website | string | - | | data.recent_orders.status | 0 | number | - | | data.recent_orders.total_amount | 1100.00 | string | - | | data.recent_orders.uid | 1111 | number | - | | data.recent_orders.updated_at | Thu, 07 Aug 2025 14:41:19 GMT | string | - | | data.total_domains | 0 | number | - | | msg | 用户后台首页统计获取成功 | string | - | | status | true | boolean | - | * 失败(404) ```javascript 暂无数据 ``` **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **Query** ### 更新域名DNS服务器 > 创建人: 吴培林 > 更新人: 吴培林 > 创建时间: 2025-08-07 23:22:05 > 更新时间: 2025-08-07 23:22:56 ```text 暂无描述 ``` **接口状态** > 已完成 **接口URL** > http://192.168.77.150:5000/api/v1/domain/manage/update_dns_servers **请求方式** > POST **Content-Type** > json **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **请求Body参数** ```javascript { "domainId": 1, "dns1": "ns1.example.com", "dns2": "ns2.example.com" } ``` **认证方式** > 继承父级 **响应示例** * 成功(200) ```javascript { "code": 0, "data": { "dns_records": [ { "MX": 55, "TTL": 600, "created_at": 1754447506, "domainID": 195631306, "domain_id": 1, "record": "cc", "recordID": 607981664, "record_id": 2, "remark": "", "state": 0, "type": "CNAME", "uid": 1111, "value": "dns.bt.cn", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461608, "domainID": 195631306, "domain_id": 1, "record": "www", "recordID": 607989402, "record_id": 5, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461803, "domainID": 195631306, "domain_id": 1, "record": "www1", "recordID": 607989413, "record_id": 6, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461963, "domainID": 195631306, "domain_id": 1, "record": "www11", "recordID": 607989562, "record_id": 7, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461989, "domainID": 195631306, "domain_id": 1, "record": "www121", "recordID": 607989567, "record_id": 8, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754462055, "domainID": 195631306, "domain_id": 1, "record": "www1223231", "recordID": 607989574, "record_id": 9, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.2", "viewID": 0 } ], "domain_info": { "created_at": 1754358178, "dns_id": 0, "dns_lock": 0, "dns_state": 0, "dns_type": 1, "domainId": 195631306, "domain_name": "wzznnnnnb", "expire_time": 1755269100, "full_domain": "wzznnnnnb.top", "id": 1, "last_operator_id": null, "last_operator_type": 0, "ns1": null, "ns2": null, "ns_status": 0, "owner_name": null, "owner_name_en": null, "real_name_status": 0, "real_name_template_id": 5, "register_time": 1754577905, "registrar": null, "registrar_domain_id": null, "remark": "一个很牛逼的域名", "status": 1, "suffix": "top", "transfer_lock": 0, "uid": 1111, "update_lock": 0, "updated_at": 1754556472 }, "real_name_info": { "address": "南城区天安数码城F8栋106", "address_en": "Room 106, Unit 8, Building 6, Tian'an Cyber Park, No. 1 Huangjin Road, Nancheng Street, Dongguan City, Guangdong Province", "business_license": "", "city": "广东省-东莞市-南城区", "contact_person": "吴培林", "created_at": 1754386208, "email": "1245@qq.com", "fail_reason": "", "id": 5, "id_image_back": "f6b9e62a71b211f0be471a4b78c8f991.jpg", "id_image_front": "dbda296e71b211f090ae1a4b78c8f991.jpg", "id_number": "441581200012111213", "id_type": 1, "is_default": 0, "owner_name": "吴培林", "owner_name_en": "wupeilin", "phone": "15579151727", "postal_code": "523000", "registrant_id": "kinfoid54960", "status": 2, "template_name": "吴培林", "template_status": "approved", "type": 1, "uid": 1111, "updated_at": 1754386857, "verify_time": "Tue, 05 Aug 2025 17:40:57 GMT" } }, "msg": "域名详情获取成功", "status": true } ``` | 参数名 | 示例值 | 参数类型 | 参数描述 | | --- | --- | ---- | ---- | | code | 0 | number | - | | data | - | object | - | | data.expiring_domains | 0 | number | - | | data.expiring_domains_top10 | - | array | - | | data.pending_orders | 22 | number | - | | data.recent_orders | - | array | - | | data.recent_orders.cancel_reason | - | null | - | | data.recent_orders.cancel_time | - | null | - | | data.recent_orders.complete_time | - | null | - | | data.recent_orders.created_at | 1754548879 | number | - | | data.recent_orders.expire_time | Fri, 08 Aug 2025 14:41:19 GMT | string | - | | data.recent_orders.id | 23 | number | - | | data.recent_orders.is_main_order | 0 | number | - | | data.recent_orders.order_no | 202508071441191cf0811a | string | - | | data.recent_orders.order_type | 1 | number | - | | data.recent_orders.product_type | domain | string | - | | data.recent_orders.refund_reason | - | null | - | | data.recent_orders.refund_time | - | null | - | | data.recent_orders.source | website | string | - | | data.recent_orders.status | 0 | number | - | | data.recent_orders.total_amount | 1100.00 | string | - | | data.recent_orders.uid | 1111 | number | - | | data.recent_orders.updated_at | Thu, 07 Aug 2025 14:41:19 GMT | string | - | | data.total_domains | 0 | number | - | | msg | 用户后台首页统计获取成功 | string | - | | status | true | boolean | - | * 失败(404) ```javascript 暂无数据 ``` **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **Query** ### 设置域名安全状态(禁止更新/禁止转移) > 创建人: 吴培林 > 更新人: 吴培林 > 创建时间: 2025-08-07 23:23:06 > 更新时间: 2025-08-07 23:23:36 ```text 暂无描述 ``` **接口状态** > 已完成 **接口URL** > http://192.168.77.150:5000/api/v1/domain/manage/set_domain_security **请求方式** > POST **Content-Type** > json **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **请求Body参数** ```javascript { "domainId": 12345, "type": "update", "status": 1 } ``` **认证方式** > 继承父级 **响应示例** * 成功(200) ```javascript { "code": 0, "data": { "dns_records": [ { "MX": 55, "TTL": 600, "created_at": 1754447506, "domainID": 195631306, "domain_id": 1, "record": "cc", "recordID": 607981664, "record_id": 2, "remark": "", "state": 0, "type": "CNAME", "uid": 1111, "value": "dns.bt.cn", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461608, "domainID": 195631306, "domain_id": 1, "record": "www", "recordID": 607989402, "record_id": 5, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461803, "domainID": 195631306, "domain_id": 1, "record": "www1", "recordID": 607989413, "record_id": 6, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461963, "domainID": 195631306, "domain_id": 1, "record": "www11", "recordID": 607989562, "record_id": 7, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754461989, "domainID": 195631306, "domain_id": 1, "record": "www121", "recordID": 607989567, "record_id": 8, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.1", "viewID": 0 }, { "MX": 55, "TTL": 600, "created_at": 1754462055, "domainID": 195631306, "domain_id": 1, "record": "www1223231", "recordID": 607989574, "record_id": 9, "remark": "", "state": 0, "type": "A", "uid": 1111, "value": "192.168.1.2", "viewID": 0 } ], "domain_info": { "created_at": 1754358178, "dns_id": 0, "dns_lock": 0, "dns_state": 0, "dns_type": 1, "domainId": 195631306, "domain_name": "wzznnnnnb", "expire_time": 1755269100, "full_domain": "wzznnnnnb.top", "id": 1, "last_operator_id": null, "last_operator_type": 0, "ns1": null, "ns2": null, "ns_status": 0, "owner_name": null, "owner_name_en": null, "real_name_status": 0, "real_name_template_id": 5, "register_time": 1754577905, "registrar": null, "registrar_domain_id": null, "remark": "一个很牛逼的域名", "status": 1, "suffix": "top", "transfer_lock": 0, "uid": 1111, "update_lock": 0, "updated_at": 1754556472 }, "real_name_info": { "address": "南城区天安数码城F8栋106", "address_en": "Room 106, Unit 8, Building 6, Tian'an Cyber Park, No. 1 Huangjin Road, Nancheng Street, Dongguan City, Guangdong Province", "business_license": "", "city": "广东省-东莞市-南城区", "contact_person": "吴培林", "created_at": 1754386208, "email": "1245@qq.com", "fail_reason": "", "id": 5, "id_image_back": "f6b9e62a71b211f0be471a4b78c8f991.jpg", "id_image_front": "dbda296e71b211f090ae1a4b78c8f991.jpg", "id_number": "441581200012111213", "id_type": 1, "is_default": 0, "owner_name": "吴培林", "owner_name_en": "wupeilin", "phone": "15579151727", "postal_code": "523000", "registrant_id": "kinfoid54960", "status": 2, "template_name": "吴培林", "template_status": "approved", "type": 1, "uid": 1111, "updated_at": 1754386857, "verify_time": "Tue, 05 Aug 2025 17:40:57 GMT" } }, "msg": "域名详情获取成功", "status": true } ``` | 参数名 | 示例值 | 参数类型 | 参数描述 | | --- | --- | ---- | ---- | | code | 0 | number | - | | data | - | object | - | | data.expiring_domains | 0 | number | - | | data.expiring_domains_top10 | - | array | - | | data.pending_orders | 22 | number | - | | data.recent_orders | - | array | - | | data.recent_orders.cancel_reason | - | null | - | | data.recent_orders.cancel_time | - | null | - | | data.recent_orders.complete_time | - | null | - | | data.recent_orders.created_at | 1754548879 | number | - | | data.recent_orders.expire_time | Fri, 08 Aug 2025 14:41:19 GMT | string | - | | data.recent_orders.id | 23 | number | - | | data.recent_orders.is_main_order | 0 | number | - | | data.recent_orders.order_no | 202508071441191cf0811a | string | - | | data.recent_orders.order_type | 1 | number | - | | data.recent_orders.product_type | domain | string | - | | data.recent_orders.refund_reason | - | null | - | | data.recent_orders.refund_time | - | null | - | | data.recent_orders.source | website | string | - | | data.recent_orders.status | 0 | number | - | | data.recent_orders.total_amount | 1100.00 | string | - | | data.recent_orders.uid | 1111 | number | - | | data.recent_orders.updated_at | Thu, 07 Aug 2025 14:41:19 GMT | string | - | | data.total_domains | 0 | number | - | | msg | 用户后台首页统计获取成功 | string | - | | status | true | boolean | - | * 失败(404) ```javascript 暂无数据 ``` **请求Header参数** | 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 | | --- | --- | ---- | ---- | ---- | | X-API-Key | BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 | string | 是 | - | | X-UID | 1111 | string | 是 | - | **Query**