文档

UAIDVerification - 根据运营商授权Token获取UAID

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

根据运营商授权Token获取UAID。 获取授权Token及其签名值请参考GetUAIDApplyTokenSign API文档。 UAID为64个长度,前32个长度描述设备信息,后32个长度描述号码信息。

接口说明

请确保在使用该接口前,已充分了解号码百科产品的收费方式和价格

根据运营商授权 Token 获取 UAID。
获取授权 Token 及其签名值请参考 GetUAIDApplyTokenSign API 文档。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dytns:UAIDVerification
  • 全部资源
    *

请求参数

名称类型必填描述示例值
OutIdstring

外部流水号。

b8b5b3a*******0b9893484fdf412c99
Carrierstring

用户所处的运营商。取值:

  • CM:中国移动。
  • CU:中国联通。
  • CT:中国电信。
CM
Tokenstring

运营商授权 Token。

说明 获取授权 Token 及其签名值请参考 GetUAIDApplyTokenSign API 文档。
MIGfMA0********3DQEBAQUAA4GNADCB
UserGrantIdstring

用户授权码,代表用户已授权。值为不大于 128 位的唯一随机数即可。

警告 集成时,建议在产品的隐私政策中加入 UAID 的隐私政策相关内容。

Md****a3Em
AuthCodestring

授权码。

说明 号码分析服务->标签广场选择标签,提交使用申请,申请通过后,会获得该授权码。
HwD97InG
Ipstring

公网 IP 地址,当运营商为联通(CU)时必传,兼容 IPV4 和 IPV6 地址。

2408:8440:308:29dc:ed00:c4ec:475c:25a4
Provincestring

省份 id,当运营商为联通(CU)时选传。与获取 token 时返回值中 province 字段保持一致。

1

返回参数

名称类型描述示例值
object
AccessDeniedDetailstring

访问被拒绝详细信息。

-
Messagestring

状态码的描述。

OK
RequestIdstring

请求 ID。

68A40250-50CD-034C-B728-0BD******177
Dataobject

返回结果。

Uaidstring

获取到的 UAID 的值。

B1E0C1********9F757AF52A035
Codestring

请求状态码。取值:

  • OK:成功。
OK

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "-",
  "Message": "OK",
  "RequestId": "68A40250-50CD-034C-B728-0BD******177",
  "Data": {
    "Uaid": "B1E0C1********9F757AF52A035"
  },
  "Code": "OK"
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterInvalid parameter.无效参数
400AuthCodeIllegalIllegal authCode.鉴权时使用的authcode不可用于该接口
500RequestTimeoutRequest supplier timed out.请求供应商超时
500RequestSupplierErrorRequest supplier error.请求第三方服务异常。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史