v1.1 https://api.perfektpak.ru/v1 REST / JSON

Внешний API ПерфектПак

Забирайте машиной те же данные, которыми живёт склад: остатки, приёмки, отгрузки, заказы FBS и метрики вашего юрлица. Заявку на приёмку теперь можно и создать через API — из 1С или любой другой учётной системы, без похода в личный кабинет.

Кому это подходит

Документация рассчитана на разработчика: 1С-программиста, инженера на стороне продавца, автора репрайсера или собственной аналитики. Четыре задачи, которые API решает за вас:

Не пере- и не недопродать — знать, сколько товара реально лежит у нас прямо сейчас (GET /v1/stock).
Контролировать оператора — собрали ли то, что обещали, и уехало ли вовремя (GET /v1/orders, GET /v1/shipments).
Заводить и закрывать приёмку из своей системы — без ручного ввода и без потери статуса на полпути (POST /v1/receipts).
Узнавать об изменениях без опроса — подписаться на вебхук вместо цикла с задержкой.

Протокол намеренно обычный: Bearer-токен, snake_case в полях, курсорная пагинация — без gRPC, OAuth и подписи запросов (кроме подписи самих вебхук-доставок, см. страницу «Вебхуки»).

С чего начать

Быстрый старт

Получить ключ и за четыре шага прочитать первые данные: GET /v1/me, затем GET /v1/stock с пагинацией. Примеры на curl, Python, PHP и 1С.

Открыть →

Справочник методов

Интерактивная документация по каждому методу: параметры, схемы, примеры, ошибки — и форма «Попробовать», которая шлёт настоящие запросы.

Открыть →

Песочница

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

Как устроена документация

Раздел	Для чего
Быстрый старт	Первый запрос, аутентификация, соглашения API, глоссарий терминов, FAQ.
Справочник методов	Все ручки по машинному контракту `/v1/openapi.yaml`, с формой «Попробовать».
Гайды	Пять сквозных бизнес-кейсов: приёмка из 1С, синхронизация остатков, статусы заказов в CRM, сверка недостач, отгрузки на СЦ.
Вебхуки	Регистрация подписки, проверка подписи, повторы, журнал доставок.
Ошибки	Все коды ошибок одним списком: HTTP-статус, что значит, что делать.
Песочница	Условия тестового контура: что можно, чего нельзя, когда всё сбрасывается.
Изменения	Журнал версий контракта.