Skip to content

PNS BIND AX

justin4515 edited this page May 19, 2025 · 4 revisions

接口说明: 绑定ax模式

概述:

  • 平台为号码A绑定一个隐私号码X,任何用户B可以拨打X,呼通A
  • 适用场景:咨询行业,如房产中介等

请求方式

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

鉴权机制

请求参数说明

  • Header参数

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

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

返回参数说明

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

data返回参数详情:

参数名 类型 说明
bindId string 绑定id
didX string 绑定的x号码

请求示例

  • CURL 格式
curl --location --request POST 'https://api.nxcloud.com/v1/pns/bind/axb' \
--header 'action: bindAX' \
--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"
    }
}

简介

短信

语音

云呼叫中心(NXLink)

云呼叫中心(AI自动外呼)

Flash Call

短链

邮件验证码

DID号码

通用

号码检测

WhatsApp

Viber

Zalo ZNS

Super Message API

隐私号(旧)

PNS

坐席(旧版)

AI Agent

Clone this wiki locally