SMS GET JSON delivery status
GET https://api.bsms.viamobile.sk/get/delivery - Request SMS delivery status
HTTP Basic Authorization
HTTP header | Value |
---|---|
Authorization | Basic base64(username:password) |
GET https://api.bsms.viamobile.sk/get/delivery?id=1 HTTP/1.1
Content-Type: text/xml;charset=UTF-8
Authorization: Basic dGVzdDp0ZXN0
Host: api.bsms.viamobile.sk
JSON Web Token (JWT) Authorization
Request JWT valid for 24 hours.
See jwt.io
See jwt.io
GET https://api.bsms.viamobile.sk/token/create?username=test&password=test HTTP/1.1
Content-Type: text/xml;charset=UTF-8
Host: api.bsms.viamobile.sk
Parameter | Required | Type | Description |
---|---|---|---|
/response/status | Required | Int32 | Server response (200 in case of success, 4xx in case of error) |
/response/jwt | Required | String | JSON Web Token |
{
"response":
{
"status": 200,
"jwt" : "xxx.yyy.zzz"
}
}
1. SMS delivery
SMS delivery - request
Parameter | Required | Type | Description |
---|---|---|---|
id |
required | int64 | unique ID of sent MT SMS |
jwt |
Optional | String | JSON Web Token |
GET https://api.bsms.viamobile.sk/get/delivery?id=123 HTTP/1.1
Content-Type: text/xml;charset=UTF-8
Authorization: Basic dGVzdDp0ZXN0
Host: api.bsms.viamobile.sk
GET https://api.bsms.viamobile.sk/get/delivery?id=123&jwt=xxx.yyy.zzz HTTP/1.1
Content-Type: text/xml;charset=UTF-8
Host: api.bsms.viamobile.sk
Response
Parameter | Type | Description |
---|---|---|
id |
int64 | unique ID of sent MT SMS |
received | timestamp | delivery report timestamp |
status | string(50) | delivered - message delivered, undeliverable - message not delivered, waiting - waiting for status, expired - message not delivered/expired |
operator | int32 | Operator code - 23101 Orange SK, 23102 Telekom SK, 23103 4rka SK, 23106 O2 SK, 23000 CZ, 0 others |
price | decimal | Message price (Message can be divided into several multipart SMSs). null, if price not configured. |
parts | int32 | Count of multipart SMSs. |
{
"response":
{
"status": 200,
"delivery":
[
{
"id": 123,
"received": "2014-02-01 22:59:00",
"status": "delivered",
"operator": 23101,
"price": 0.03,
"parts": 1
}
]
}
}