API и вебхуки для продавцов

API позволяет управлять объявлениями, ценами, складом и сделками из своей программы или бота.

Ключ

1. Откройте API и вебхуки и создайте ключ, выбрав права.
2. Ключ вида mk_… показывается один раз — сохраните его.
3. Передавайте ключ в заголовке Authorization: Bearer mk_….

Права: listings:read (чтение объявлений и склада), listings:write (создание, цены, склад), deals:read (сделки и чаты), deals:write (отметка выдачи и сообщения в чат сделки). Можно держать до 10 активных ключей, ненужный — «Отозвать».

Вебхуки

Площадка присылает POST на ваш https-адрес при событиях сделок: оплата, выдача, завершение, спор, возврат, отмена. Тело подписывается: X-Signature: sha256=HMAC_SHA256(secret, тело) — проверяйте подпись. Неудачная доставка повторяется до 3 раз.

Лимиты

120 запросов в минуту на ключ; при превышении — ответ 429 с заголовком Retry-After.

Полная документация — на странице API для разработчиков.