MSISDN status JSON
Description
Service for checking MSISDN status.
Usage
All requests has to be sent to URLs below.
In case of success, HTTP response code 200 is returned and message body contains response = information about MSISDN status In case of error, HTTP response error code is returned.
In case of success, HTTP response code 200 is returned and message body contains response = information about MSISDN status In case of error, HTTP response error code is returned.
Request
POST https://api.bsms.viamobile.sk/json/msisdnstatus
Request body
{
"username": "test",
"password": "test",
"msisdns":
[ "421903123456", "421904123456"
]
}
| Parameter | Required | Type | Description |
|---|---|---|---|
username |
required | string(32) | user login |
password |
required | string(32) | user password |
msisdns |
required | string[] | list of MSISDN |
Response
{
"response":
{
"status": 200,
"msisdns":
[
{
"msisdn": "421903123456",
"status": "ACTIVE"
},
{
"msisdn": "421904123456",
"status": "INVALID"
}
]
}
}
| Parameter | Type | Description |
|---|---|---|
msisdn |
string | phone numer / MSISDN |
| status | string | ACTIVE - MSISDN is active, INVALID = MSISDN is not active |
Error response
{
"response":
{
"status": 401,
"code": 1000,
"description": "Unauthorized"
}
}
Error codes
| HTTP Code | Code | Description | Info |
|---|---|---|---|
| 401 | 1000 | Unauthorized | unknown username or password |
| 401 | 1010 | MSISDN status not permitted | MSISDN status service is not permitted - please contact Viamobile |
| 500 | unknown error | unknown error - please contact Viamobile |
Versions
| Version | Date | Description |
|---|---|---|
| 2.1 | 12.8.2015 | MSISDN status service added |