获取域名列表

所需 OAuth scope：domain:read

分页获取当前用户的域名白名单。仅 pending 且未验证的域名返回验证信息（verification_subdomain、verification_token、expires_at、domain_connect_url）；带 omitempty 的字段为空时不返回。

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

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

错误响应：

code	msg
401	authorization header is missing
401	invalid token
403	OAuth2权限不足，需要以下权限之一: domain:read
500	获取域名列表失败

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "domains": [
      {
        "id": 7,
        "domain": "example.com",
        "is_verified": true,
        "status": "verified",
        "has_beian": true,
        "beian_number": "京ICP备12345678号",
        "verified_at": "2026-09-24T10:10:00+08:00",
        "remark": "主站",
        "created_at": "2026-09-24T10:00:00+08:00"
      },
      {
        "id": 8,
        "domain": "example.org",
        "is_verified": false,
        "status": "pending",
        "verification_subdomain": "lolia_ab12cd34.example.org",
        "verification_token": "x9y8z7w6v5u4t3s2",
        "has_beian": false,
        "expires_at": "2026-09-25T10:00:00+08:00",
        "created_at": "2026-09-24T10:00:00+08:00"
      }
    ],
    "total": 2,
    "page": 1,
    "limit": 10
  }
}

🟠401错误 401

🟠403错误 403

🔴500错误 500

请求参数

请求示例代码

返回响应