> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vargopartners.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Все эндпоинты

> Что умеет API — одной таблицей

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

## Витрина

| Метод | Путь | Что делает |
| - | - | - |
| `GET` | [`/account`](/api/account) | Название сервиса, наценка, включён ли пробный период. Первая проверка ключа |
| `GET` | [`/plans`](/api/plans) | Тарифы и доп. устройства с ценами для клиента |
| `GET` | [`/payment-methods`](/api/payment-methods) | Способы оплаты, доступные клиенту сейчас |
| `GET` | [`/documents`](/api/documents) | Ссылки на соглашение и политику под названием вашего сервиса |

## Оплата

| Метод | Путь | Что делает |
| - | - | - |
| `POST` | [`/payments`](/api/create-payment) | Счёт на подписку, продление или доп. устройства. Нового клиента заводит сам |
| `GET` | [`/payments/{payment_id}`](/api/get-payment) | Состояние счёта; после оплаты — вместе с клиентом и ссылкой подписки |

## Клиенты

| Метод | Путь | Что делает |
| - | - | - |
| `GET` | [`/clients/{client_id}`](/api/get-client) | Статус и срок подписки, ссылка подписки, ссылки подключения |
| `GET` | [`/apps`](/api/apps) | VPN-приложения и ссылки на установку — для экрана подключения |
| `POST` | [`/clients/{client_id}/trial`](/api/start-trial) | Пробный период, если он включён вашему аккаунту |
| `GET` | [`/clients`](/api/list-clients) | Все ваши клиенты постранично, с фильтром по статусу подписки |

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

| Метод | Путь | Что делает |
| - | - | - |
| `GET` | [`/clients/{client_id}/devices`](/api/list-devices) | Подключённые устройства и лимит |
| `DELETE` | [`/clients/{client_id}/devices/{device_id}`](/api/delete-device) | Отключить устройство и освободить место |
| `POST` | [`/clients/{client_id}/rotate-link`](/api/rotate-link) | Новая ссылка подписки вместо старой |

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

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

Схема OpenAPI целиком: [`openapi.json`](https://api.vargopartners.com/api/partner/v1/openapi.json) — открыта, ключ не нужен.