Отправка SMS

База знаний
→
Общие вопросы

Отправка SMS

Создает новый объект сообщения. Notificore присылает ID отправленных сообщений, после каждого оставленного запроса. Максиму 50 номер, обрабатываются за один запрос.

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

Parameter	Type	Description
destination	string	The sender of the message. This can be a telephone number (including country code) or an alphanumeric string. In case of an alphanumeric string, the maximum length is 11 characters. Required
body	string	The body of the SMS message. Required
msisdn	string	The telephone number. Required
reference	string	A client reference. Required
phones	array	The array of recipients msisdn’s and reference’s. Required Set only for multiple message request (“destination”: “phones”).

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

Parameter	Type	Description
validity	int	The amount of seconds that the message is valid.
tariff	int	Tariff code of a price grid.

ЗНАЧЕНИЯ

PUT (POST) https://api.notificore.ru/v1.0/sms/create

RETURNS
Returns a message object if the request was successful. If the request failed, an error object will be returned.

ПРИМЕР ЗАПРОСА (ОДНОСОСТАВНОЕ СООБЩЕНИЕ)

{
    "destination": "phone",
    "originator": "alpha name",
    "body": "message text",
    "msisdn": "380972000000",
    "reference": "ext_id_16",
    "validity": "1",
    "tariff": "0",
    "callback_url": "your_url"
}

ПРИМЕР ОТВЕТА (ОДНОСОСТАВНОЕ СООБЩЕНИЕ)

{
    "result":
    {
        "error": 0,
        "errorDescription": "No errors",
        "reference": "ext_id_16",
        "id": "213",
        "price": 0.23,
        "currency": "EUR"
    }
}

ПРИМЕР ЗАПРОСА (МНОГОСОСТАВНОЕ СООБЩЕНИЕ)

{
    "validity": "1",
    "tariff": "0",
    "destination": "phones",
    "originator": "alpha_name",
    "body": "message text",
    "phones":
    [
        {
            "msisdn": "380972000000",
            "reference": "ext_id_17"
        },
        {
            "msisdn": "380972000001",
            "reference": "ext_id_18"
        }
    ],
    "callback_url": "your_url"
}

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

Attribute	Type	Description
task_id	int	An unique random ID which is created for multiple request

ПРИМЕР ОТВЕТА (МНОГОСОСТАВНОЕ СООБЩЕНИЕ)

{
“task_id”:”6″,
“result”:[
{
“error”:0,
“errorDescription”:”No errors”,
“reference”:”ext_id_17″,
“id”:”214″,
“price”:0.23,
“currency”:”EUR”
},
{
“error”:0,
“errorDescription”:”No errors”,
“reference”:”ext_id_18″,
“id”:”215″,
“price”:0.23,
“currency”:”EUR”
}
],
“total_price”:0.46,
“currency”:”EUR”
}