Skip to main content
Базовый адрес — https://api.vargopartners.com/api/partner/v1. Каждый запрос — с ключом Authorization: Bearer vgo_live_….

​
Витрина

​
Оплата

​
Клиенты

​
Устройства и ссылка

​
Что требует внимания

  • POST /payments без Idempotency-Key не работает. Повтор с тем же ключом и теми же полями отвечает 200 тем же счётом и replayed: true, а не выставляет второй. Подробно — Начало работы.
  • 201 и 200 на POST /payments — оба успех. 201 — счёт выставлен сейчас, 200 — это повтор.
  • expired не окончательный. Поздняя оплата переводит счёт в succeeded; failed бывает и после succeeded, если банк отозвал платёж.
  • Перевыпуск ссылки необратим. Старая ссылка перестаёт работать сразу, клиент добавляет подписку в приложение заново. Не чаще раза в час на клиента.
  • Удаление устройства необратимо — устройство отключается; вернуть его можно, только подключив заново.
  • Пробный период — настоящий доступ и выдаётся клиенту один раз: если подписка у клиента уже была, ответ 409 TRIAL_ALREADY_USED.
  • 401 и 429 возможны на любом запросе: ключ не принят или превышен лимит. Пауза до повтора — в заголовке Retry-After. Подробно — Ошибки и лимиты.
Схема OpenAPI целиком: openapi.json — открыта, ключ не нужен.