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

时间：2023-11-01 16:16:20

表2 请求URL参数说明
参数名称	是否必选	参数类型	说明
origNum	否	String(1-32)	指定A号码查询绑定信息。填写为全局号码格式（包含国家码），并需要把号码中的+号转义为%2B，例如：%2B86138**0021或%2B8675528**02。该参数与subscriptionId 、privateNum为三选一关系。同时携带origNum 、subscriptionId和privateNum时以subscriptionId为准。同时携带origNum和subscriptionId时以subscriptionId为准。同时携带origNum和privateNum时以origNum为准。
subscriptionId	否	String(1-64)	指定“AX模式绑定接口”返回的绑定ID查询绑定信息。该参数与origNum 、privateNum为三选一关系。同时携带origNum 、subscriptionId和privateNum时以subscriptionId为准。同时携带origNum和subscriptionId时以subscriptionId为准。同时携带subscriptionId和privateNum时以subscriptionId为准。
privateNum	否	String(1-32)	指定查询绑定关系的X号码，填写为全局号码格式（包含国家码），并需要把号码中的+号转义为%2B。例如：%2B86138****0021。该参数与origNum 、subscriptionId为三选一关系。同时携带origNum 、subscriptionId和privateNum时以subscriptionId为准。同时携带origNum和privateNum时以origNum为准。同时携带subscriptionId和privateNum时以subscriptionId为准。

表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()转换后的时间格式去除毫秒后即为本接口要求的时间格式。