Посмотрите, как это работает
Пошаговый пример · вымышленные данные
Создайте серверный ключ
Создайте ключ в разделе разработчика и храните на сервере. Он ограничен вашим аккаунтом, кошельком и заказами; не помещайте его в публичный фронтенд.
Этот пример не изменяет ваш аккаунт.
Прочитать все шаги
- Создайте серверный ключ
Создайте ключ в разделе разработчика и храните на сервере. Он ограничен вашим аккаунтом, кошельком и заказами; не помещайте его в публичный фронтенд.
- Ключ API
- ••••••••
- Доступ
- Только этот аккаунт и магазин
- Используйте актуальный контракт
Используйте документацию и схему на хосте своего магазина. Авторизация — X-API-Key или Bearer. До покупки получите баланс, сервисы и сроки.
- Базовый URL
- https://sms.red/api/v1/developer
- Авторизация
- X-API-Key: <server-held key>
- До покупки
- Баланс → сервисы → сроки аренды
- Используйте новый ключ идемпотентности
Для новой покупки — новый ключ: 8–128 ASCII букв, цифр, подчёркиваний или дефисов. Укажите срок в миллисекундах и предел maxPrice из согласованной цены.
- Ключ идемпотентности
- demo-purchase-1042
- Поля запроса
- durationMs · maxPrice
- Восстановитесь после неясного ответа
Сначала проверьте попытку покупки или свои заказы. Повторяйте ту же покупку с тем же ключом; новый ключ может вызвать ещё одно списание.
- Существующая попытка
- demo-purchase-1042
- Следующее действие
- Проверить попытку → тот же ключ при повторе
- Обработка ошибок и смена ключей
401: ключ отсутствует, отключён, заменён или от другого магазина. 404: проверьте владение и наличие. 400: поля, баланс и предел цены. Управляйте ключами в кабинете; API поддерживает только документированные действия.
- 401
- Проверьте ключ и магазин
- 404
- Проверьте владение / наличие
- 400
- Проверьте запрос, баланс и предел
Создание и защита ключа
Откройте Разработчика и ключи API. Создайте ключ с названием и сохраните безопасно. Он работает с кошельком и заказами своего аккаунта в магазине, не даёт административного доступа или переключения аккаунтов запросом.
Отключение, удаление или перевыпуск отзывают старые данные. После перевыпуска старый ключ недействителен. Храните на сервере, не в публичном браузерном коде, скриншотах и репозитории.
Актуальный контракт
База SMS.Red: https://sms.red/api/v1/developer. Для партнёрского магазина — его домен. Авторизация: X-API-Key или Authorization: Bearer YOUR_API_KEY. Используйте документацию и текущую схему.
До покупки читайте баланс и услуги. Списки различают otp и rent, страну, наличие и сроки в миллисекундах. Покупка использует реальный идентификатор услуги, страну, срок и предел цены. Дополнительные поля зависят от операции.
Безопасные повторы
Для каждой новой покупки новый Idempotency-Key, для её повтора — прежний. Допустимы 8–128 ASCII-букв, цифр, подчёркиваний или дефисов. После таймаута проверьте попытку документированным запросом. Изменение данных с прежним ключом может дать конфликт.
GET /api/v1/developer/balance
X-API-Key: YOUR_API_KEYЭто чтение с примером, не настоящий ключ. Для оплаты следуйте текущим примерам покупки. Заказы и сообщения доступны по документированным методам; отмена требует доступности и подтверждения.
Ошибки и сообщения
401: ключ отсутствует, отозван, перевыпущен или другой магазин. 404: недоступные/чужие данные. 400: поля, средства или цена. При неясном серверном результате сохраните ключ покупки и проверьте попытку, не создавайте новую вслепую.
Для входящих событий используйте вебхуки. Не предполагается, что API содержит каждую кнопку панели: проверяйте контракт.
Нужна помощь с аккаунтом?
Открыть поддержку