Перейти к содержанию

Начало работы

Обзор

Документация содержит описание API cервисов для отправки и приема SMS, VIBER сообщений и PUSH уведомлений.

Каждый раздел включает в себя:

  • описание схемы работы с API,
  • подробное описания параметров запроса,
  • примеры запросов.

Документация предназначена для разработчиков, которые хотят добавить возможность взаимодействия с сервисами отправки SMS-сообщений, VIBER-сообщений и PUSH-уведомлений на страницы своих сайтов или в свои приложения.

Для начала использования API:

  • зарегистрируйтесь в Личном кабинете,
  • заключите договор,
  • ознакомьтесь с интересующей документацией,
  • отправляйте запросы на https://api.devino.online.

Авторизация

Методы авторизации

Все запросы API требуют аутентификации. Нужно установить HTTP-заголовок авторизации, который должен включать тип и учетные данные.

Authorization: <type> <credentials>

Devino API поддерживает два типа авторизации:

  • API KEY - генерация API ключа.
  • Basic - комбинация логина и пароля, закодированная Base64.

API Key

API Key - это самый гибкий и безопасный тип авторизации. Ключи API могут иметь ограниченную область действия и охватывать только некоторые методы API, кроме того они могут быть отозваны в любое время. Это делает ключи авторизации подходящими для разделения прав доступа API между несколькими приложениями.

Для получения API Key нужно:

Authorization: Key YWxhZGRpbjpvcGVuc2VzYW1l

Basic

Базовый тип авторизации, может использоваться в ситуациях, когда ключ API недоступен. В этом случае заголовок авторизации представляет собой комбинацию логина и пароля от личного кабинета в кодировке Base64.

Создание заголовка аутентификации:

  • Имя пользователя и пароль объединяются с использованием двоеточия (:) в качестве разделителя login:password.
  • Результирующая строка кодируется с использованием Base64.
  • Закодированная строка добавляется после типа "Basic".
Authorization:  Basic YWxhZGRpbjpvcGVuc2VzYW1l