🔌 API Migom (v1)

REST-API для продавцов и интеграций: управляйте листингами, стоком, заказами и автовыдачей программно.

Базовый адрес

https://migom.org/api/v1/

Все ответы — JSON. Все эндпоинты работают только с данными владельца ключа.

🔑 Авторизация

Создайте ключ в кабинете: Кабинет → API и webhooks (после входа). Ключ показывается один раз — сохраните его.

Передавайте ключ одним из заголовков:

Authorization: Bearer <ВАШ_КЛЮЧ>
# или
X-API-Key: <ВАШ_КЛЮЧ>

GET/ping

Проверка ключа. Возвращает имя владельца.

curl -H "Authorization: Bearer $KEY" https://migom.org/api/v1/ping
→ {"ok": true, "user": "yourname"}

GET/listings · POST/listings

Список ваших листингов / создание нового.

title *	заголовок
service *	код сервиса (привязка стока)
price *	цена
currency	RUB (по умолчанию) / USDT / CNY
category	slug категории
description, is_active	необязательно

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title":"ChatGPT Plus","service":"chatgpt","price":"990","category":"ai-chatgpt"}' \
  https://migom.org/api/v1/listings
→ {"id": 42, "title": "ChatGPT Plus"}

GET/stock · POST/stock

Остатки по сервисам / добавить единицу своего легального стока (см. правила площадки).

service *	код сервиса
login , password	данные доступа
login_url	необязательно

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"service":"chatgpt","login":"a@b.c","password":"***"}' \
  https://migom.org/api/v1/stock
→ {"id": "…", "service": "chatgpt"}

GET/orders

Последние ваши продажи (до 200).

curl -H "Authorization: Bearer $KEY" https://migom.org/api/v1/orders
→ {"orders": [{"id": 7, "listing": "ChatGPT Plus", "amount": "990.00",
              "status": "completed", "created_at": "…"}]}

POST/fulfill

Зарезервировать единицу стока и получить одноразовую ссылку выдачи /d/<token> — для коннекторов: оплата прошла на внешней площадке, а товар выдаёт Migom.

service *	код сервиса
buyer_ref, external_ref	ваши метки заказа

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"service":"chatgpt","external_ref":"funpay#123"}' \
  https://migom.org/api/v1/fulfill
→ {"order_id":"…","token":"…","delivery_url":"https://migom.org/d/…"}   # 409 если стока нет

🔔 Webhooks

События (order.paid, dispute.opened, выдача и др.) можно получать на свой URL. Эндпоинты настраиваются в кабинете — Кабинет → API и webhooks.

← на главную