Specification 1.0
API URL
The URL used to send the HTTP requests:
https://sms.gretor.net/api/1.0/simple/transactional
Supported methods
It is strictly prohibited to exploit transactional SMS for promotional/marketing uses. It must be used for notification purposes only – as an SMS notification.
Parameters table
| PARAMETER NAME | VALUE | MANDATORY | DEFAULT VALUE |
|---|---|---|---|
| application_id | Application indentificator | Yes | – |
| application_token | Application authentication token | Yes | – |
| number | Recipient number | Yes | – |
| text | Text of SMS message (max. 612 characters, or 268 characters if Unicode is used), UTF-8 enconding | Yes | – |
| unicode | Yes/true/1 for Unicode SMS, no/false/0 for 7bit SMS |
No | false |
| flash | Yes/true/1 for flash SMS |
No | false |
| sender_id | Sender ID, viz sender ID type | No | gSystem |
| sender_id_value | Sender value of gOwn or gText |
No | null |
| country | Provide the recipients’ numbers in an international format (with prefix, e.g. 44) or add the country code in ISO 3166-1 alpha-2 format (7820125799 + GB = 447820125799). See the country example request. If null, your set timezone will be used to fill the information |
No | null |
| schedule | Schedule the sending time and date in unix timestamp, or ISO 8601. | No | Now |
| duplicates_check | Select on to prevent sending duplicate messages to the same phone number. Messages with the same text sent to the same number will be removed if there is a time interval shorter than 5 mins. If off no duplicates will be removed. |
No | off |
Sender ID type sender_id
| VALUE | DESCRIPTION |
|---|---|
gSystem |
System number |
gShort |
Short Code |
gText |
Text sender |
gOwn |
Own Number (number verification required) |
<int> |
Gretor SMS Profile ID |
Response to this command may be:
In case of success:
{
"data": {
"status": "accepted",
"sms_id": "tmpde1bcd4b1d1",
"price": 0.02,
"credit": 215.81380,
"number": "447700900000"
}
}
In case of error:
{
"error": "authentication_failed",
"code": 401
}
