Быстрый старт
За 5–10 минут: ключ → первый 200 OK → выбор сценария (CRM, каталог, проценка).
1. Роль и ключ API
В панели управления:
- Система → Настройка API
- Роли API — отметьте права. Для проверки можно включить все, потом сузить
- Ключи API — создайте ключ, привяжите роль
Сохраните идентификатор (например pp_abc123) и секрет (показывается при создании).
Опционально укажите точку выдачи у ключа — тогда заказы ограничены этой точкой.
Подробнее: Авторизация, Структура и обозначения.
2. Первый запрос
bash
curl -sS "https://ВАШ_ДОМЕН/api/integrations/v1/modules" \
-H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
-H "Accept: application/json"json
{
"ok": true,
"payment": [
{ "id": 3, "name": "Банковский перевод", "type": "payment", "is_active": true }
],
"delivery": [
{ "id": 2, "name": "Самовывоз", "type": "delivery", "is_active": true }
]
}| HTTP | Что проверить |
|---|---|
401 | Формат Bearer, identifier и секрет |
403 | Нет права modules.read |
200 | Ключ живой |
3. Куда дальше
| Цель | Страница |
|---|---|
| CRM: заказы, позиции, статусы | Работа с заказами · Статусы |
| CRM: документы ↔ внешний ID | Документы |
| Клиенты | Пользователи и организации |
| Остатки / каталог из учёта | Каталог и остатки |
| Проценка → заказ | Проценка |
| Карта всех методов | Все методы API |