隐私保护通话 PrivateNumber-AX模式解绑接口:请求参数

时间:2025-02-12 15:00:54

请求参数

表2 请求URL参数说明

参数名称

是否必选

参数类型

说明

origNum

String(1-32)

AX中的A号码。

填写为全局号码格式(包含国家码),并需要把号码中的+号转义为%2B,例如:%2B86138****0021或%2B8675528****02。

系统不会解析该参数,可不携带。

privateNum

String(1-32)

AX中的X号码。

填写为全局号码格式(包含国家码),并需要把号码中的+号转义为%2B,例如:%2B86138****0021。

系统可通过subscriptionId或privateNum确定唯一一个绑定关系,即不携带subscriptionId时,必须携带privateNum。

subscriptionId

String(1-64)

指定“AX模式绑定接口”返回的绑定ID解除绑定关系。

请求携带了subscriptionId时,系统会以subscriptionId的值为准,不关注privateNum参数。

表3 请求Headers参数说明

参数名称

是否必选

参数类型

说明

Content-Type

String

固定填写为application/json;charset=UTF-8。

Authorization

String

固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。

X-AKSK

String

取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。
  • PasswordDigest:根据PasswordDigest = Base64 (HMAC-SHA256 (Password,Nonce + Created))生成。其中,Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可,无需包含+号和空格。
  • Nonce:客户发送请求时生成的一个随机数,长度为1~128位,可包含数字和大小写字母。例如:66C92B11FF8A425FB8D4CCFE0ED9ED1F。
  • Created:随机数生成时间。采用标准UTC格式,例如:2018-02-12T15:30:20Z。不同编程语言中将UTC时间戳转换为普通时间时使用的格式不同,部分语言可参考表4
表4 不同编程语言的时间格式

编程语言

时间格式

Java

yyyy-MM-dd'T'HH:mm:ss'Z'

PHP

Y-m-d\TH:i:s\Z

Python

%Y-%m-%dT%H:%M:%SZ

C#

yyyy-MM-ddTHH:mm:ssZ

Node.js

toISOString().replace(/.[0-9]+\Z/, 'Z')

注:Node.js中,使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。

support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0012.html