PNS BIND AXE

接口说明: 绑定axe模式

概述：

• 平台为号码A绑定一个隐私号码X和一个分机号E，任何用户B可以拨打X，输入分机号E，呼通A
• 适用场景:外卖、快递行业等

请求方式

• URL: https://api.nxcloud.com/v1/pns/bind/axe
• Method: POST
• Content-Type: application/json
• 是否需要鉴权: 是

鉴权机制

• 鉴权规则参考地址: API接口调用约定

请求参数说明

• Header参数

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

• Body 参数

| 参数名 | 必填 | 类型 | 说明 | | ----------------------- |--- -| ------ |-----------------------------------------------| | businessId | 是 | string | 应用key | | phoneA | 是 | string | A的号码 | | bindExpireSecond | 是 | int | 绑定关系的过期时间(单位秒),默认7200s | | didX | 否 | string | 预期绑定的X号码，有值时选择固定DID，无值时随机选择DID | | customerBindId | 否 | string | 客户自定义的绑定id（由客户决定，需要保证唯一,系统会根据该字段做幂等），可为空 | | recording | 否 | boolean | 是否录音,默认false | | ext | 否 | string | 自定义字段,会在话单时透传 | | iso2X | 否 | string | didX的iso2, 当didX没有传时，该值可以指定didX的方向 |

返回参数说明

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

data返回参数详情：

参数名	类型	说明
bindId	string	绑定id
didX	string	绑定的x号码
extensionX	string	x号码的分机号(4位)

请求示例

• CURL 格式

curl --location --request POST 'https://api.nxcloud.com/v1/pns/bind/axb' \
--header 'action: bindAXE' \
--header 'bizType: 5' \
--header 'accessKey: yyds' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'ts: 1728359394964' \
--header 'sign: d73f48559784e6c8b8c54ec9aa85bc1b' \
--data-raw '{
    "phoneA": "85213215564",
    "bindExpireSecond": 300,
    "ext": "it is ext",
    "recording": true
}'

返回示例

{
    "code": 0,
    "msg": "success",
    "requestId": "1843499034666340352",
    "data": {
        "bindId": "75a1a571f98a2b24505fbfa14aba87a6",
        "didX": "8521313564",
        "extensionX": "2563" 
    }
}