Мамо Купи

Для бізнесу

Документація API

API для магазинів і роботодавців з пакетом «Мега». Авторизація — ключ із бізнес-кабінету в заголовку Authorization: Bearer ym_live_…. Ліміт — кількість запитів на хвилину на ключ (за замовчуванням 60). Нові й змінені оголошення проходять модерацію так само, як із кабінету.

Базова адреса: https://yarmarok.vercel.app/api/v1 · специфікація OpenAPI 3.1: openapi.json · ключі — у кабінеті

Ендпоінти

GET/api/v1/listingsСписок оголошень

  • status (query) — draft | pending | active | inactive | rejected
  • limit (query)
  • offset (query)

POST/api/v1/listingsСтворити або оновити до 500 позицій

Ключ позиції — external_id, інакше part_number + brand. Фото завантажуються за URL. Нульова кількість знімає позицію з показу.

PATCH/api/v1/listingsЗняти з показу або опублікувати

DELETE/api/v1/listingsВидалити неактивні оголошення

GET/api/v1/listings/{id}Одне оголошення

  • id (path)

GET/api/v1/applicationsВідгуки на вакансії

  • status (query) — new | viewed | shortlisted | interview | hired | rejected | withdrawn
  • listing_id (query)
  • limit (query)
  • offset (query)

GET/api/v1/leadsЗвернення покупців (діалоги)

  • limit (query)
  • offset (query)

GET/api/v1/ordersЗамовлення (зарезервовано)

Поля позиції

  • external_id — Ваш код товару (ID, SKU)
  • title * — Назва
  • description — Опис
  • price * — Ціна, ₴
  • category * — Категорія (назва або slug)
  • city — Місто
  • part_number — Номер деталі (OEM)
  • part_numbers_extra — Кросс-номери (через ; або ,)
  • brand — Виробник деталі
  • part_condition — Стан (нова / б/у / відновлена)
  • originality — Оригінальність
  • quantity — Кількість
  • warranty_days — Гарантія, днів
  • photos — Фото (URL через ; , | або пробіл)
  • compat_make — Сумісність: марка
  • compat_model — Сумісність: модель
  • compat_year_from — Сумісність: рік з
  • compat_year_to — Сумісність: рік по

category — slug або точна назва кінцевої категорії. Стан: «нова», «б/у», «відновлена». Оригінальність: «оригінал», «аналог», «неоригінал якісний».

Приклад

curl -X POST https://yarmarok.vercel.app/api/v1/listings \
  -H "Authorization: Bearer ym_live_…" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"external_id":"SKU-1","title":"Фільтр масляний Bosch","price":350,
       "category":"filtry-to","city":"Київ","part_number":"0451103316","brand":"Bosch",
       "part_condition":"нова","quantity":5,"photos":["https://cdn.example.com/1.jpg"]}]}'

Помилки

Формат: { "error": { "code": "rate_limit", "message": "…" } }. 401 — ключ, 403 — немає пакета «Мега», 404 — не знайдено, 429 — ліміт (повторіть через Retry-After секунд), 400 — невірні дані. Помилки окремих позицій у POST не зупиняють решту — вони в масиві results.