С чего начать

API для отправки кодов авторизации

Для начала нужно получить API ключ

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

Куда отправлять запросы

Запросы можно отправлять как с помощью методов GET, так и POST на https://sendcode.ru/v1.

Убедитесь, что заголовок Content-Type установлен в application/json.

Поле Authorization должно содержать ваш API ключ. Также токен можно передавать в URL через параметр token, однако мы не рекомендуем так делать из соображений безопасности.

Сервис всегда будет отвечать кодом 200, за исключением ситуаций с некорректным форматом запроса.

Неудачные запросы не тарифицируются.

Запрос баланса

https://sendcode.ru/v1/balance

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

OK

{
  "ok": true,
  "balance": 90.55,
  "tier": 1
}

Error

Отправка кода

https://sendcode.ru/v1/send

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body params

Name	Value
number	Номер в формате E.164
length?	Можно передать длину кода от 4 до 8 (по умолчанию 4 знака)
code?	Если передан будет отправлен ваш код

Response

OK

{
  "ok": true,
  "number": "[phone]",
  "code": "9042",
  "cost": 0.45
}

Error