Developers

MarketHub API

REST API для інтеграції MarketHub зі своїми системами. Workspace-scoped — кожен API ключ має доступ тільки до даних одного робочого простору. Машинно-читабельна специфікація (OpenAPI 3.1) — /api/openapi.json.

Швидкий старт

  1. 1. Створіть API ключ: Налаштування → API ключі. Скопіюйте значення одразу — після закриття діалогу повторно його не побачите.
  2. 2. Передавайте ключ заголовком Authorization: Bearer mh_….
  3. 3. Зробіть тестовий запит:
curl -H "Authorization: Bearer mh_…" https://markethub.kiev.ua/api/orders?page=1&pageSize=10

Усі суми — у гривнях (₴), не копійках. Час повертаємо в UTC, формат ISO 8601. Rate-limit: 60 запитів/хв на workspace; перевищення → HTTP 429 з заголовкомretry-after.

Ендпоїнти

Згруповано за тегом. Повні схеми та приклади — у OpenAPI JSON.

General

Ендпоїнти групи General
МетодШляхОпис
GET/api/healthService health probe

Orders

Orders that came in from any sales channel.

Ендпоїнти групи Orders
МетодШляхОпис
GET/api/ordersList orders
POST/api/ordersCreate a manual order

Customers

End-customer profiles. Phone is the natural key per workspace.

Ендпоїнти групи Customers
МетодШляхОпис
GET/api/customersList customers
POST/api/customersCreate a customer

Products

Product catalog with stock + price per channel.

Ендпоїнти групи Products
МетодШляхОпис
GET/api/productsList products

Shipments

TTN tracking — Nova Poshta today; Ukrposhta on the roadmap.

Ендпоїнти групи Shipments
МетодШляхОпис
GET/api/shipmentsList shipments