Перейти к содержанию

Запись в два шага

Операции записи требуют одноразового токена. Сначала GET на тот же адрес — в ответе access_token со временем жизни в одну минуту. Затем POST на тот же адрес с заголовком X-Access-Token. Токен одноразовый: на вторую запись нужен новый.

Тело POST — объект-обёртка со списком: имя обёртки указано у каждой операции, предел пакета — десять записей за вызов.

Пример

Шаг 1 — одноразовый токен:

curl -s "https://app.masterkassa.com/api/add-product" \
  -H "Authorization: Bearer $MK_TOKEN" \
  -H "Accept: application/json"

В ответе — access_token, живёт одну минуту.

Шаг 2 — сама запись, с токеном в отдельном заголовке:

curl -s -X POST "https://app.masterkassa.com/api/add-product" \
  -H "Authorization: Bearer $MK_TOKEN" \
  -H "X-Access-Token: $ACCESS_TOKEN" \
  -H "Accept: application/json" \
  -d 'products=[{"name":"Кофе зерновой","sku":"COFFEE-1","categoryId":1}]'

Токен одноразовый: на вторую запись нужен новый первый шаг.

У каких операций

  • GET+POST /api/add-product — Создание записей. Пакет до 10 записей.
  • GET+POST /api/edit-product — Изменение записей. Пакет до 10 записей.
  • GET+POST /api/add-product-category — Создание записей. Пакет до 100 записей.
  • GET+POST /api/edit-product-category — Изменение записей. Пакет до 100 записей.
  • GET+POST /api/add-product-brand — Создание записей. Пакет до 100 записей.
  • GET+POST /api/edit-product-brand — Изменение записей. Пакет до 100 записей.
  • GET+POST /api/update-product-prices — Операция update_prices. Пакет до 100 записей.
  • GET+POST /api/add-contractor — Создание записей. Пакет до 100 записей.
  • GET+POST /api/edit-contractor — Изменение записей. Пакет до 100 записей.

Дальше