咨询热线:0755-33548988
订单小号绑定接口
1.订单小号绑定接口介绍

开发者调用订单小号绑定接口前,需要先建立号码池(具体方法可联系工作人员)。号码池建立后,通过本接口动态申请一个可用X号码(可指定),该号码可用于映射真实号码A,B之间的通话。

2.请求地址

  /{softVersion}/Accounts/{accountSid}/AxbNumber/bind

REST API是通过HTTPS POST方式请求。

4.请求包体
参数名称 类型 约束 说明
appId String 必选 应用ID
telA String 必选 通话A号码,支持手机和固话
telX String 可选 通话双方显示的X号码,可指定
telB String 必选 通话B号码,支持手机、固话和95号码
areacode String 可选 申请小号的区号,根据这一参数在号码池中选择对应的号码,如不传此参数在号码池所有号码中选择
otherArea String 可选 只能输入true或false,默认为false。当输入true时,输入的areacode区的X号码池无资源时,允许从其他区号资源池随机选取X号码
callDisplay String 可选 显号控制,0:显示真实号码,1:显示X 号码;默认值0。并不是所有的X号码资源都支持显示真实号码,关于这点请咨询客服
expiration int 可选 绑定关系有效时长,秒为单位。必须大于0,若为空则默认24小时
userData String 可选 用户自定义数据,最长可支持128字节。如用户配置了回调接口,则在回调接口中将这一数据原样返回

参数说明:

(1).appId:应用ID
(2).telA:通话A号码,支持手机和固话
(3).telX:通话双方显示的X号码,不传入时会在X号码池随机选取
(4).telB:通话B号码,支持手机、固话和95号码
(5).areacode:申请小号的区号,根据这一参数在号码池中选择对应的号码,如不传此参数在号码池所有号码中选择
(6).otherArea:只能输入true或false,默认为false。当输入true时,输入的areacode区的X号码池无资源时,允许从其他区号资源池随机选取X号码
(7).callDisplay:显号控制,0:显示真实号码,1:显示X 号码;默认值0。并不是所有的X号码资源都支持显示真实号码,关于这点请咨询客服
(8).expiration:绑定关系有效时长,秒为单位。必须大于0,默认24小时
(9).userData:用户自定义数据,最长可传入128字节,用户配置回调接口的情况下,将数据返回回调接口

请求示例

JSON请求示例
      POST
      /2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/AxbNumber/bind?sig=
      6949C5F977B304EC5BB969FD8838D345HTTP/1.1
      Host:127.0.0.1:9080
      content-length: 272
      Accept: application/json;
      Content-Type: application/json;charset=utf-8;
      Authorization: Nzk4YjllYzBlYWE5NDE0Mjg1MjYwMmM0AAI1NzAxNDY6MjAxNjAzMjQxNTE3MDE=
      {
         "req": {
           "appId":"7290fa01293c483fb2709c690f213272",
           "telA":"18617068888",
           "telX":"13036894925",           
           "telB":"13410247777",
           "areacode":"0779",
           "otherArea":"true",
           "expiration":"60",
           "userData":"AA,BB,CC"
         }
      }
                            
XML请求示例
      POST
      /2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/AxbNumber/bind?sig=
      230AB7B77C951C9DB5FECD55B3AFB3CFHTTP/1.1
      Host:127.0.0.1:9080
      content-length: 357
      Accept: application/xml;
      Content-Type: application/xml;charset=utf-8;
      Authorization: Nzk4YjllYzBlYWE5NDE0Mjg1MjYwMmMAADI1NzAxNDY6MjAxNjAzMjQxNjA2MjI=
      <?xml version='1.0' encoding='utf-8'?>
      <req>
          <appId>7290fa01293c483fb2709c690f213272</appId>
          <telA>18617068888</telA>
          <telX>13036894925</telX>
          <telB>13410247777</telB>
          <areacode>0779</areacode>
          <otherArea>true</otherArea>
          <expiration>60</expiration>
          <userData>AA,BB,CC</userData>
      </req>
                            
5.响应包体
属性 类型 约束 说明
statusCode String 必选 请求状态码,取值000000(成功),可参考 Rest 错误代码
dateCreated String 必选 响应时间:格式"yyyy/MM/dd HH:mm:ss"。如:2016/01/01 12:00:00
represent String 可选 错误描述,报错时返回,请求正常不返回
subid String 可选 系统分配,唯一标示本次绑定关系的ID,解绑时使用
telX String 可选 系统分配的小号X
info String 可选 非本区X号码,本区X号码资源池用完后,返回本参数

响应示例

JSON响应示例
      HTTP/1.1 200 OK 
      Content-Length: 126
      {
        "resp": {
          "statusCode": "000000",
          "dateCreated": "2016/03/24 15:36:52",
          "subid": "A2102X779X0008005970",
          "telX": "13036894925",
          "info": "非本区X号码"
        }
      }
                            
XML响应示例
      HTTP/1.1 200 OK 
      Content-Length: 197
      <?xml version='1.0'?>
      <resp>
          <statusCode>000000</statusCode>
          <dateCreated>2016/03/24 16:12:44</dateCreated>
          <subid>A2102X779X0008005970</subid>
          <telX>13036894925</telX>
          <info>非本区X号码</info>
      </resp>
                            

1 订单小号绑定...

2 请求地址

3 请求包头

4 请求包体

5 响应包体


在线客服

在线语音

点击呼叫

音频设备正常
点击"呼叫"立即接通客服
麦克风设备未准备好
请检查设备后再点击"呼叫"
音频设备未准备好
请检查设备后再点击"呼叫"
呼叫中……
请耐心等待
00:00
通话中
通话已结束
时长: 00:00
通话未接通
非常抱歉!客服未能接通。请再次呼叫或在官网下方留下您的联系方式,我们将尽快与您沟通。

电话咨询
0755-33548988

回到顶部