Песочница

Тестовый контур для интеграции: свой ключ, свои данные, без обращения к менеджеру и без риска для боевого склада.

Получить ключ

Без авторизации, с лимитом запросов по IP:

curl -X POST https://api.perfektpak.ru/v1/sandbox/keys

{ "key": "pp_test_9k2M7pQ1…", "expires_after_idle": "24h", "docs": "/docs/sandbox" }

Что в песочнице

Каждый ключ pp_test_ открывает свою собственную, изолированную копию сценария вымышленного селлера «ИП Ромашкина Е. В.»: два кабинета (WB и Ozon), 24 товара, несколько приёмок и отгрузок, около 180 заказов за последние 30 дней. Все ручки /v1/* работают в точности как с боевым ключом — тот же формат ответов, те же ошибки, та же пагинация. Данные разных тестовых ключей не пересекаются между собой и никогда не пересекаются с боевыми данными. GET /v1/me тестовым ключом дополнительно помечает клиента: client.name содержит пометку «(песочница)», а key.preview начинается с pp_test_ — по этому признаку легко отличить тестовый ответ от боевого в логах.

Песочница живёт во времени

Статический фикстур бесполезен для проверки интеграции с вебхуками и статусами — поэтому песочница не стоит на месте:

заявка, созданная через POST /v1/receipts, сама подтверждается примерно через минуту (PENDING_CONFIRMATION → EXPECTED);
ещё через минуту начинается приёмка (→ RECEIVING);
ещё через две — завершается: RECEIVED, либо RECEIVED_WITH_DISCREPANCY, если external_ref начинается с TEST-SHORT — так можно сознательно вызвать сценарий расхождения, не дожидаясь его случайно;
заказы в фоне тоже двигаются по нормализованным статусам;
вебхуки из песочницы доставляются по-настоящему, на ваш реальный URL, с настоящей подписью — тестовая среда для обработчика вебхука не отличается от боевой.

Вернуть сценарий к исходному состоянию в любой момент:

curl -X POST https://api.perfektpak.ru/v1/sandbox/reset \
  -H "Authorization: Bearer $PP_TEST_KEY"

Условия и ограничения

Никогда не заносите в песочницу боевые данные

Песочница — не резервная копия и не черновик боевой интеграции: состояние может быть сброшено в любой момент, SLA на неё нет.

Состояние теряется после 24 часов без единого запроса этим ключом.
SLA не предоставляется — это тестовый контур, а не продакшен.
Лимит запросов на получение ключа — по IP, чтобы не плодить бесконечные тестовые организации.
Обычные лимиты /v1/* (60 в минуту, всплеск 20) действуют и на тестовый ключ так же, как на боевой.

Что дальше

Пройдите «Быстрый старт» с тестовым ключом от начала до конца, или откройте справочник методов — форма «Попробовать» там по умолчанию уже настроена на песочницу.