Home > API Center > API interface guide
Submit AB for Binding
POST
https://api.laaffic.com/v3/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.
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.laaffic.com/v3/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 |
Was this page helpful?
Questions about integration? Contact our technical support
LAAFFIC API dedicated TG technical support channel, real-time response to your needs