验证域名

POST

https://api.lolia.link/api/v1/user/domain/verify

最后修改时间：2026-11-01 13:14:59

所需 OAuth scope：domain:write

通过查询 DNS TXT 记录验证域名所有权：需先在 verification_subdomain 添加值为 verification_token 的 TXT 记录。验证成功后状态变为 verified，并自动查询 ICP 备案信息（查询失败不影响验证结果）。验证需在添加后 24 小时内完成，过期需删除后重新添加。

鉴权：OAuth2 Access Token，Authorization: Bearer {{oauthAccessToken}}

OAuth2：支持 OAuth2 Access Token，需要 scope domain:write

错误响应：

code	msg
401	authorization header is missing
401	invalid token
403	OAuth2权限不足，需要以下权限之一: domain:write
400	请求参数错误: <校验错误>
400	域名记录不存在
400	域名已验证
400	验证已过期，请重新添加域名
400	DNS查询失败，请确保已添加TXT记录: <错误信息>
400	TXT记录验证失败，请确保在 <verification_subdomain> 添加了TXT记录，值为: <verification_token>

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
  "domain": "example.com"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.lolia.link/api/v1/user/domain/verify' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "domain": "example.com"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "domain": "example.com",
    "is_verified": true,
    "verified_at": "2026-09-24T10:10:00+08:00",
    "status": "verified",
    "has_beian": true,
    "beian_number": "京ICP备12345678号"
  }
}

🟠401错误 401

🟠403错误 403

🟠400错误 400

修改于 2026-11-01 13:14:59

添加域名

删除域名