隐私保护通话 PrivateNumber-AXE模式绑定信息查询接口:请求参数

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

表2 请求URL参数说明
参数名称	是否必选	参数类型	说明
virtualNum	否	String(1-32)	X号码，携带为全局号码格式（包含国家码），并需要把号码中的+号转义为%2B，如：%2B86170****0021。该参数必须与extendNum同时携带，指定唯一一组绑定关系。
extendNum	否	String(1-4)	分机号E，最大4位，如：1234。该参数必须与virtualNum同时携带，指定唯一一组绑定关系。
subscriptionId	否	String(0-64)	指定“AXE模式绑定接口”返回的绑定ID查询绑定关系携带该参数时系统以该参数为准，可不关注virtualNum和extendNum参数。

表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。不同编程语言中的时间格式转换方式不同，部分语言可参考表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()转换后的时间格式去除毫秒后即为本接口要求的时间格式。