Початок роботи

SkyService API — JSON API для рітейлу, складу та фінансів. Конкретну операцію задають два query-параметри: section і action.

Базовий URL

Базова адреса API індивідуальна для кожної компанії — вона залежить від сервера, на якому розміщено вашу компанію. Візьміть її з кабінету: на сторінці API-токени показані ваші baseUrl і companyId.

<baseUrl>/?section={section}&action={action}

• GET — читання (параметри в query-рядку).
• POST — зміни (тіло у форматі JSON).

Формат відповіді

Кожна відповідь — JSON із полем status:

{ "status": "done", "data": {} }

У разі помилки:

{ "status": "error", "error": ["error message"] }

Бізнес-помилки повертаються з HTTP-кодом 200 — завжди перевіряйте поле status, а не лише HTTP-статус.

Перший запит

curl "<baseUrl>/?section=products&action=getProducts&companyId=<companyId>&token=<token>"

<baseUrl> і <companyId> беруться з кабінету (сторінка API-токенів), <token> — ваш API-токен.

Далі — Автентифікація.