Документация

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

Обновлено 26 сентября 2026 г. · 1 мин чтения
Markdown
  • База: https://api.astrum.shop/v1. Все запросы — JSON, ответы — no-store.
  • Ключ: Authorization: Bearer ask_live_…. Выдаётся одноразовой ссылкой (раздел «Ключи»), показывается один раз.
  • Документация: https://astrum.shop/docs, справочник методов — https://astrum.shop/docs/reference, спецификация — https://api.astrum.shop/v1/openapi.json (OpenAPI 3.1, по ней генерируются клиенты).

Первые запросы

curl -s https://api.astrum.shop/v1/me -H "Authorization: Bearer $ASTRUM_KEY"
curl -s https://api.astrum.shop/v1/catalog -H "Authorization: Bearer $ASTRUM_KEY"
curl -s https://api.astrum.shop/v1/orders/quote -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"product_id": "…", "quantity": 1}]}'

Области ключа

GET /v1/me показывает ключ (открытую часть), его области, лимиты, статус партнёра, вебхук (без секрета) и версию принятых условий. Области ключа:

Область Что даёт
catalog:read каталог опта
orders:write смета, создание и отмена заказов
orders:read заказы с товаром, активации, события order.* и activation.*
activations:write данные клиента, повтор, force, ссылка входа card_pay
wallet:read аванс, леджер, адреса и депозиты, события аванса; свой порог алерта
webhooks:manage адрес вебхука, секрет подписи, тестовое событие

Заказ оплачивается авансом сразу при создании

POST /v1/orders списывает оптовую сумму и выдаёт товар в той же операции (раздел «Заказы и товар»).

Страница помогла?
НазадОбзорДалееПравила интеграции