Delivery reports over SOAP
WSDL: https://api.bsms.viamobile.sk/soap?wsdl
Endpoint: https://api.bsms.viamobile.sk/soap
Method: GetDeliveryStatus
HTTP Basic Authorization
| HTTP header | Value |
|---|---|
| Authorization | Basic base64(username:password) |
POST https://api.bsms.viamobile.sk/soap HTTP/1.1
Content-Type: text/xml;charset=UTF-8
SOAPAction: "http://bsms.viamobile.sk/GetDeliveryStatus"
Authorization: Basic dGVzdDp0ZXN0
Host: api.bsms.viamobile.sk
Error codes
| Code | Message | Description |
|---|---|---|
| 1000 | Unknown username/password | Unknown username or password |
1. Delivery report
Delivery report - request
| Parameter | Required | Type | Description |
|---|---|---|---|
/messageIds/id |
Required | Int64 | Unique message ID from client system |
POST https://api.bsms.viamobile.sk/soap HTTP/1.1
Content-Type: text/xml;charset=UTF-8
SOAPAction: "http://bsms.viamobile.sk/GetDeliveryStatus"
Authorization: Basic dGVzdDp0ZXN0
Host: api.bsms.viamobile.sk
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:bsms="http://bsms.viamobile.sk/">
<soapenv:Header/>
<soapenv:Body>
<bsms:messageIds>
<id>1</id>
<id>2</id>
</bsms:messageIds>
</soapenv:Body>
</soapenv:Envelope>
Delivery report - response
| Parameter | Required | Type | Description |
|---|---|---|---|
/messageDeliveryStatus/id |
Required | Int64 | Unique message ID from client system |
/messageDeliveryStatus/status |
Required | String | send status: ok - sent
blacklist - MSISDN blacklisted error - could not send/error notAllowed - MSISDN not permitted for testing network_disabled - destination network forbidded |
/messageDeliveryStatus/price |
Optional | Decimal | Message price (message can be divided into several multipart SMSs).
Null, if price not configured. |
/messageDeliveryStatus/parts |
Required | Decimal | Count of multipart SMSs. |
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://bsms.viamobile.sk/">
<SOAP-ENV:Body>
<ns1:messageDeliveryStatuses>
<ns1:messageDeliveryStatus>
<id>1</id>
<status>delivered</status>
<price>0.05</price>
<parts>1</parts>
</ns1:messageDeliveryStatus>
<ns1:messageDeliveryStatus>
<id>2</id>
<status>waiting</status>
<price>0.1</price>
<parts>2</parts>
</ns1:messageDeliveryStatus>
</ns1:messageDeliveryStatuses>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>