• KB Home
  • SME API
  • SME API: SMS
  • Получение данных по отправителям (подписям) о тарифах на отправку сообщений (subjectTariffs)

Получение данных по отправителям (подписям) о тарифах на отправку сообщений (subjectTariffs)

Метод, описанный в этой статье, предназначен только для SME.

В результате выполнения запроса возвращаются данные о тарифах на отправку сообщений для имеющихся у клиента подписей. Тарифы зависят от типа сообщения, например, сервисное сообщение дешевле рекламного. А также от оператора связи, на номера которого отправляются сообщения. В ответ на запрос возвращается JSON со списком зарегистрированных для клиента подписей, а для каждой подписи указаны тарифы по операторам.

URL-адрес подключения

Для получения данных о тарифах для каждой подписи выполняется запрос на URL-адрес: https://sms.edna.ru/connector_sme/api/subjectTariffs

Формат запроса

Формально запрос без параметров, но необходимо передать APIKey клиента в заголовке запроса X-API-KEY.

Формат ответа

В ответ на запрос возвращается JSON-объект, содержащий данные о тарифах для каждой подписи клиента с разбивкой тарифов по операторам связи.

{
    "subjectTariffs": [
        {
            "subject": " subj4_upd ",
            "destinationTariffs": [
                {
                    "destinationCode": "russia-beeline",
                    "destinationName": "Россия Билайн",
                    "serviceMessagePrice": "1.850",
                    "advertMessagePrice": "2.100"
                },
                {
                    "destinationCode": "russia-megafon",
                    "destinationName": "Россия МегаФон",
                    "serviceMessagePrice": "1.850",
                    "advertMessagePrice": "2.100"
                },
                {
                    "destinationCode": "russia-tele2",
                    "destinationName": "Россия ТЕЛЕ2",
                    "serviceMessagePrice": "1.850",
                    "advertMessagePrice": "2.100"
                },
                {
                    "destinationCode": "russia",
                    "destinationName": "Россия",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "2.350"
                },
                {
                    "destinationCode": "russia-mts",
                    "destinationName": "Россия МТС",
                    "serviceMessagePrice": "1.850",
                    "advertMessagePrice": "2.100"
                }
            ]
        },
        {
            "subject": "SaleAkt",
            "destinationTariffs": [
                {
                    "destinationCode": "russia-beeline",
                    "destinationName": "Россия Билайн",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "1.000"
                },
                {
                    "destinationCode": "russia-megafon",
                    "destinationName": "Россия МегаФон",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "1.000"
                },
                {
                    "destinationCode": "russia-tele2",
                    "destinationName": "Россия ТЕЛЕ2",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "1.000"
                },
                {
                    "destinationCode": "russia",
                    "destinationName": "Россия",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "1.000"
                },
                {
                    "destinationCode": "russia-mts",
                    "destinationName": "Россия МТС",
                    "serviceMessagePrice": null,
                    "advertMessagePrice": "1.000"
                }
            ]
        }
    ]
}

Параметры ответа

ПараметрТип данныхОписание
destinationCodestring (required)Код оператора. Значение russia — для всех российских операторов, кроме «большой четверки»
destinationNamestring (required)Наименование оператора. Значение Россия — для всех российских операторов, кроме «большой четверки»
serviceMessagePricestring (required)Cтоимость сервисного сообщения
advertMessagePricestring (required)Стоимость рекламного сообщения

Получение данных подписи SMS по её идентификатору (smsSubject)
Cледующая статья Отправка SMS-сообщения (smsOutMessage)