Отправка 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”
}