Sandbox

Полноценная копия production-API для тестирования интеграции. Тот же формат запросов и ответов, те же эндпоинты — но без реальных денег, реальных ключей и реальных заказов.

Отдельный набор тестовых ключей

Управляемые сценарии ответов

Данные сбрасываются каждые 24 часа

Sandbox vs Production

Base URL (sandbox): sandbox.api.giftapi.com
Base URL (production): api.giftapi.com
Ключ авторизации: sk_test_...
Реальные заказы поставщикам: Не создаются
Webhook-события: Отправляются как в production

Как получить доступ

Получите тестовый ключ

Ключ sk_test_... доступен сразу после регистрации, без верификации бизнеса.

Замените base URL

Направьте запросы на sandbox.api.giftapi.com с тем же телом запроса.

Переключитесь на прод

Смените ключ и base URL — код интеграции остаётся без изменений.

Тестовые идентификаторы для проверки логики

test_successcompleted: Успешная выдача с первого раза
test_out_of_stockfailed: Имитирует отсутствие товара
test_pendingpending: Зависает на 30 секунд перед завершением
test_invalid_accountfailed: Имитирует невалидный номер/аккаунт
test_webhook_retrypending: Проверка повторной отправки webhook

Подставьте эти значения вместо реального product_id или player_id, чтобы протестировать обработку ошибок без подбора реальных условий.

Тестовый заказ с управляемым исходом

POST sandbox.api.giftapi.com/orders

{
"product_id": "test_out_of_stock",
"quantity": 1
}

ОТВЕТ

{
"status": "failed",
"error_code": "out_of_stock"
}

Чем sandbox отличается от прода

Сброс данных каждые 24 часа

Все тестовые заказы и балансы обнуляются раз в сутки.

Тестовые ключи не работают в проде

sk_test_... ключи отклоняются на api.giftapi.com и наоборот.

Более жёсткий rate limit

100 запросов в минуту вместо лимита production-тарифа.

Каталог — ограниченное подмножество

В sandbox доступны не все 2000+ позиций, а репрезентативный набор.

Частые вопросы

Приходят ли webhook-уведомления в sandbox?

Да, на тот же URL, что настроен для production, но с пометкой "sandbox": true в теле события — можно отличить тестовые события от боевых на одном обработчике.

Можно ли протестировать реальный товар из каталога?

Да, обычные product_id из каталога тоже работают в sandbox и всегда возвращают успешный результат — используйте тестовые идентификаторы из блока 4 только для проверки ошибок.

Нужна ли верификация бизнеса для sandbox?

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

Что произойдёт, если случайно использовать sandbox-ключ в проде?

Запрос будет отклонён с ошибкой 401 — ключи каждого окружения работают только со своим base URL.