API 文档
文档目录
服务与支持 API 文档 获取帐户信息
获取帐户信息

1. 接口描述

本接口 User.Detail 获取帐户信息。
接口请求地址:https://dnsapi.cn/User.Detail
HTTP请求方式:POST

2. 请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 公共请求参数页面。

参数名 是否必须 参数描述
公共参数 详见: 公共请求参数

3. 响应代码

以下请求参数列表仅列出了此接口请求响应代码,除此接口请求响应代码外。还包含 共通返回码

响应码 描述
共通返回

4. 示例

curl -X POST https://dnsapi.cn/User.Detail -d 'login_token=LOGIN_TOKEN&format=json'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2015-01-18 15:04:07"
    },
    "info": {
        "user": {
            "real_name": "",
            "user_type": "personal",
            "telephone": "187****3214",
            "im": "",
            "nick": "DNSPod 先生",
            "id": "625033",
            "email": "api@dnspod.com",
            "status": "enabled",
            "email_verified": "no",
            "telephone_verified": "no",
            "weixin_binded": "no",
            "agent_pending": false,
            "balance": 0,
            "smsbalance": 0,
            "user_grade": "DP_Free"
        },
        "agent": {
            "discount": "100",
            "points": "0",
            "balance_limit": "yes",
            "users": "1"
        }
    }
}
  • 字段说明:
字段名 说明
real_name 用户名称, 企业用户对应为公司名称。
user_type 账号类型:[“personal”,”enterprise”],分别对应个人用户和企业用户。
telephone 电话号码。
im 用户 IM (已废弃)。
nick 用户昵称。
id 用户 ID, 即为 user_id。
email 用户账号, 邮箱格式。
status 账号状态:”enabled”: 正常;”disabled”: 被封禁。
email_verified 邮箱是否通过验证:”yes”: 通过;”no”: 未通过。
telephone_verified 手机是否通过验证:”yes”: 通过;”no”: 未通过。
weixin_binded 是否绑定微信:”yes”: 通过;”no”: 未通过。
agent_pending 是否正在申请成为代理:true: 是;false: 否。
balance 账号余额。
smsbalance 剩余短信条数。
user_grade 账号等级, 按照用户账号下域名等级排序, 选取一个最高等级为账号等级, 具体对应情况参见域名等级。
agent 仅当前是代理用户时,返回该字段,包含代理及其名下用户信息。
最近更新于 2020-09-08 11:29