PNS API bind extension

接口说明

将A、X、分机号、B做绑定，绑定时分机号和虚拟号须同时传。 例如：将A号码分配给用户，X号码为用户持有的隐私号，其他的任何号码拨打X号码+分机号都转接到A号码，A拨打X的时候呼叫会转接到绑定时所传入的默认B号码。

请求url

https://number.nxcloud.com/api/pns/

请求头

参数名	类型	必填	说明	示例值
accessKey	string	是	用户的accessKey	fme2na3kdi3ki
action	string	是	请求方法	bindAXBExtension
bizType	string	是	[业务类型] 固定值 用来标识隐私号服务	5
ts	string	是	当前请求的时间戳（单位是毫秒），牛信服务端允许用户端请求最大时间误差为60秒	1655710885431
sign	string	是	API入参参数签名，签名算法

请求体

参数名	必填	类型	说明
phoneA	是	string	A的号码，A、B号码的国码须保持一致
phoneB	否	string	B的号码，A、B号码的国码须保持一致
phoneX	是	string	预期绑定的X号码，须与A、B号码的国码保持一致
Extension	是	string	分机号，3位
customerBindId	否	string	客户自定义的绑定id（由客户决定，需要保证唯一），可为空
flag	否	int	其他标识,比特组合,0:none,1:录音
expireSecond	是	int	过期秒数,若是为0，代表不过期

返回参数

参数名	类型	说明
code	int	返回码，0代表成功，其他失败
msg	string	返回码描述
requestId	string	请求id
data	Object	请求数据id
data返回参数详情：

参数名	类型	说明
bindId	string	pns的绑定id，后续计费都会基于此
did	string	pns的绑定虚拟号码

请求示例

请求url

https://number.nxcloud.com/api/pns/

Header

KEY	VALUE
accessKey	sixgqophrnv4
ts	1670479632933
bizType	5
action	bindAXBExtension
sign	faxxxxxxxxxxxxxxxxxxxxxxxxxxxxd4

Body

{
  "phoneA": "446075363777",
  "phoneB": "448646607772",
  "phoneX": "447401264117",
  "extension": "101",
  "expireSecond": 86400,
  "customerBindId": "66666666",
  "flag": 1
}

返回示例

{
  "code": 0,
  "msg": "success",
  "requestId": "1602248485121429504",
  "data": {
    "bindId": "f6e24ebdaf64ef91adb0b60e3b582db0",
    "did": "85235753351"
  }
}