列出证明材料类别

选择证明材料类别

为某个身份准备所需证明材料时，请使用返回的类别和实体类型。此列表说明的是类别，并非您已上传的文件，也不表示任何证明材料已获批准。

符合实际要求

某个类别出现在列表中，并不意味着它满足所有国家、号码类型或客户身份的要求。上传证明材料前，请阅读适用要求，并将返回的标识符视为不透明值，不要推断其内部结构或含义。

请求

通过 HTTPS 使用已启用的 API 账户凭据。支持基本身份验证和已启用的 API 账户持有者令牌；账户限制仍然适用。

使用 GET，并将文档中规定的任何参数放在 URL 路径中。

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

响应

除 HTTP 状态外，还要检查 JSON 正文中的 status.code。response 是一个数组，其中的对象包含 id、name 和 entity_type 字段。这些值来自当前的证明材料目录。标识符是不透明值；请直接复制返回的标识符，不要自行构造或通过哈希计算生成。成功的响应也可能返回空目录。不要根据此示例将完整的实体类型枚举硬编码到程序中。

此处仅示意响应结构，并非账户实时数据或当前报价。

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

错误

检查 status.code 和 status.msg，以了解身份验证或服务错误。成功返回空目录并不表示文件已获批准，也不表示可免于注册。

可用性及附带影响

此目录或要求查询不会创建身份、上传证明材料、注册号码或下单。
目录查询成功并不表示您的文件已获批准，也不确认所选号码可以激活。