Быстрый старт
От ключа до созданного заказа за три запроса.
Создайте ключ
Владелец магазина открывает Настройки → Интеграции → API и создаёт ключ с нужными правами. Секрет показывается один раз, сохраните его сразу.
Проверьте ключ
curl https://refsales.ru/api/v1/credentials \
-H "Authorization: Bearer rsk_live_xxx"В ответе будут магазин, права ключа и срок действия.
Прочитайте заказы
curl "https://refsales.ru/api/v1/orders?with=items&limit=20" \
-H "Authorization: Bearer rsk_live_xxx"Следующую страницу запрашивайте с cursor из page.nextCursor.
Создайте заказ
curl -X POST https://refsales.ru/api/v1/orders \
-H "Authorization: Bearer rsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"externalId": "A-1001",
"customer": { "name": "Иван", "phone": "+79990000000" },
"items": [{ "productId": "<uuid>", "quantity": 1, "unitPrice": 150000 }]
}'unitPrice указан в копейках: 150000 = 1 500 ₽. Вместо productId можно
передать sku или externalProductId, а без unitPrice возьмётся цена из
каталога. Повтор запроса с тем же
externalId вернёт уже созданный заказ, дубля не будет.