API Center/Submit AB for Binding
 
 

Submit AB for Binding

POST
https://api.itniotech.com/number/pns/bind
Establish the AXB/AXXB binding.
Assume that the user side: phoneA, phoneB, middle number: pnsNumberA, pnsNumberB (pnsNumberA=pnsNumberB in AXB mode) In this case, pnsNumberA is displayed for phoneA, and pnsNumberB is displayed for phoneB. If a phoneA calls pnsNumberA, it can be transferred to phoneB. In this case, the phoneB sees the calling number is pnsNumberB. A phoneB call to pnsNumberB can be transferred to phoneA, and the calling number displayed by phoneA is pnsNumberA.
 
Request Parameters
Parameters Description Required Type
phoneA A's number. A and B need to be the same country code. 1-20 characters. Yes String
phoneB B's number. A and B need to be the same country code. 4-20 characters. Yes String
poolNumber Number pool calling number. Select the middle number from the number pool. 1-20 characters. Yes String
expireS The expiration time of the bond, in seconds. A positive integer ranging from 1 to 259200. Yes Integer
appId app id Yes String
bizType Type, 1-AXB, 2-AXXB. Yes Integer
 
Request Sample
Request URL:
    https://api.itniotech.com/number/pns/bind
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "phoneA": "9188067701",
    "phoneB":"9188067799",
    "poolNumber":"918806",
    "expireS":60,
    "bizType":1,
    "appId":"4luaKsL2"
}
 
Response Parameters
Parameters Description Type
status Status code, 0 is successful, other failures refer to the interface response code String
reason Failure cause description String
data JSONObject
pnsNumberA Middle number 1. pnsNumber1=pnsNumber2 in AXB mode, different in AXXB mode String
pnsNumberB Middle number 2. pnsNumber1=pnsNumber2 in AXB mode, different in AXXB mode String
bindId Binding relationship ID String
 
Response Sample
{
    "status": "0",
    "reason": "success",
    "data":{
        "pnsNumberA":"9188061024",
        "pnsNumberB":"9188061024",
        "bindId":1002
    }
}
 
Response Status Code
status Description
0 Successful
-1 Abnormal account authentication
-2 Ip restrictions
-16 Timestamp expired
-18 System anomalies
-22 Parameter exception
-29 WorkSpace disabled
-30 API Key disabled
-31 Ip is not in the whitelist
-35 An AXB binding relationship exists for number A or number B
-41 No available middle number found
Number Records are Actively Pushed
Unbind AB

Feedback

Was this page helpful?