• + 237 222314319

Message Submission

This API allows us to send messages from our applications. Whether it is a message to one person, a message to a group or a message to several numbers.

PRODUCTION_URL https://didstation.com/sms_http_api
SAMPLE_REQUEST https://www.didstation.com/sms_http_api&lang=en&username=smstest&password=191979&from=econsulting&to=237695877264&message=just_to_see_01&dlr=1&message_type=0&route_type=1

Paramètre

Champ Type Description
username string

Username of the user.

password string

Password of the user.

type string

It indicates the type of message.
Values for "type" include:
0 : Plain text (GSM 3.38 Character encoding)
1 : Flash (GSM 3.38 Character encoding)
2 : Unicode
3 : Reserved
5 : Plain text (ISO-8859-1 Character encoding)
6 : Unicode Flash
7 : Flash (ISO-8859-1 Character encoding)

dlr string

Indicates whether the client wants delivery report for this message.
The values for "dlr" include:
0 : No delivery report required
1 : Delivery report required

destination string

Mobile number to which the message is to be sent
(may or may not include a plus [+] sign).
Multiple mobile numbers need to be separated by a comma (,)
(the comma should be URL encoded).

source string

The source address that should appear in the message.
- Max Length of 18 if numeric.
- Max Length of 11 if alphanumeric.
To prefix the plus sign (+) to the sender’s address when the message is displayed on their mobile phone, please prefix the plus sign to your sender’s address while submitting the message.
Note: You need to URL encode the plus sign.
The SMSC may enforce additional restrictions on this field.

message string

The message to be sent.
It can be used for 'long' messages, that is, messages longer than 160 characters for plain text, 140 for flash, and 280 for Unicode.
For concatenated (long) messages every 153 characters are counted as one message for plain text and 268 characters for Unicode. The system uses the rest of the characters for packing extra information for reassembling the message on the mobile phone.

Success Code

Champ Description
1701

Success. Message submitted successfully.
Response will be in below format :
1701|<CELL_NO>|<MESSAGE_ID>

You can then use the message ID later to map the delivery report to the message.

Error Codes

Nom Description
1702

Invalid URL. This means that one of the parameters was not provided or left blank.

1703

Invalid value in username or password field.

1704

Invalid message type.

1705

Invalid message.

1706

Invalid destination.

1707

Invalid source (Sender ID).

1708

Invalid dlr value.

1709

User validation has failed.

1710

Internal error.

1715

Response timeout.

1025

Insufficient credit.

1032

DND reject.

1028

Spam message.

Balance Check

This API allows us to send messages from our applications. Whether it is a message to one person, a message to a group or a message to several numbers.

PRODUCTION_URL https://didstation.com/sms_http_api
SAMPLE_REQUEST https://www.didstation.com/sms_http_api&lang=en&username=smstest&password=191979&from=econsulting&to=237695877264&message=just_to_see_01&dlr=1&message_type=0&route_type=1

Champ Type Description
username string

Username of the user.

password string

Password of the user.

Response Message

Nom Description
AUTHORIZATION_FAILED

User is inactive
or
The credentials provided (username or password or both) are wrong.

BALANCE

Credit balance remaining in the account.

INVALID_URL

Username or Password or both are incorrect.

INTERNAL_ERROR

Cannot fetch credit balance.

PERMISSION_DENIED

You have reached the maximum number of allowed hits.

Add a review

Response Message

Nom Description
AUTHORIZATION_FAILED

User is inactive
or
The credentials provided (username or password or both) are wrong.

BALANCE

Credit balance remaining in the account.

INVALID_URL

Username or Password or both are incorrect.

INTERNAL_ERROR

Cannot fetch credit balance.

PERMISSION_DENIED

You have reached the maximum number of allowed hits.

Delivery Repport

This API allows us to send messages from our applications. Whether it is a message to one person, a message to a group or a message to several numbers.

PRODUCTION_URL https://didstation.com/sms_http_api
SAMPLE_REQUEST https://www.didstation.com/sms_http_api&lang=en&username=smstest&password=191979&from=econsulting&to=237695877264&message=just_to_see_01&dlr=1&message_type=0&route_type=1

Champ Type Description
sSender string

Source address.

sMobileNo string

Destination number of sent message.

sStatus string

Status of the message.
(‘UNKNOWN’, ’ACKED’, ‘ENROUTE’, ’DELIVRD’, ’EXPIRED’, ’DELETED’, ’ UNDELIV’, ’ACCEPTED’, ’REJECTD’)

dtSubmit string

Date and time when the message is submitted.
Date format should be YYYY-MM-DD
Time format should be hh:mm:ss

dtDone string

Date and time when the delivery report is received.
Date format should be YYYY-MM-DD
Time format should be hh:mm:ss

sMessageId string

Unique identification for a message given at the time of submission.

iCostPerSms string

Cost per message or SMS.

iCharge string

Total credits deducted depending upon number of message parts.

iMCCMNC string

Mobile Country Code and Mobile Network Code.

iErrCode string

No error=0
Error=Respective error code
Example : 205 (Unknown Error)

sTagName optionnel string

Campaign name for that batch.

sUdf1 optionnel string

User defined field 1.

sUdf2 optionnel string

User defined field 2.

Error Codes

Nom Description
200

OK:
The request has succeeded.
The information returned with response is dependent on the method used in the request.

202

Accepted:
The request has been accepted for processing, but the processing is not complete.

Note

The response codes other than 200 or 202 are not taken into consideration and requests for such response codes are considered as failed.
The method used for posting the delivery report onto the client’s URL is POST.

Add a review

Subscribe to our newsletter