allinssl/frontend/apps/domain-management-backend/doc/域名管理.md

22 KiB

全局公共参数

全局Header参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

全局Query参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

全局Body参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

全局认证方式

无需认证

状态码说明

状态码 中文描述
暂无参数

用户侧

创建人: 吴培林

更新人: 吴培林

创建时间: 2025-08-02 08:59:42

更新时间: 2025-08-02 08:59:46

暂无描述

目录Header参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录Query参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录Body参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录认证信息

继承父级

Query

域名管理

创建人: 吴培林

更新人: 吴培林

创建时间: 2025-08-05 10:48:09

更新时间: 2025-08-07 14:51:09

暂无描述

目录Header参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录Query参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录Body参数

参数名 示例值 参数类型 是否必填 参数描述
暂无参数

目录认证信息

继承父级

Query

获取域名列表

创建人: 吴培林

更新人: chudong

创建时间: 2025-08-07 16:12:06

更新时间: 2025-08-07 22:02:11

暂无描述

接口状态

已完成

接口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参数

{
    
}

认证方式

继承父级

响应示例

  • 成功(200)
{
	"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": "<div><span class='Pcurrent'>1</span><span class='Pcount'>共1条数据</span></div>",
		"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)
暂无数据

请求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

暂无描述

接口状态

已完成

接口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参数

{
    "domain_id": 1
}

认证方式

继承父级

响应示例

  • 成功(200)
{
	"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)
暂无数据

请求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

暂无描述

接口状态

已完成

接口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参数

{
  "domainId": 1,
  "dns1": "ns1.example.com",
  "dns2": "ns2.example.com"
}

认证方式

继承父级

响应示例

  • 成功(200)
{
	"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)
暂无数据

请求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

暂无描述

接口状态

已完成

接口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参数

{
  "domainId": 12345,
  "type": "update",
  "status": 1
}

认证方式

继承父级

响应示例

  • 成功(200)
{
	"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)
暂无数据

请求Header参数

参数名 示例值 参数类型 是否必填 参数描述
X-API-Key BT_DOMAIN_API_2024_a8f3d9e2c1b7f4a6 string -
X-UID 1111 string -

Query