Партнерський API
Серверний API для партнерів: створюйте клієнтів, надавайте тарифи та керуйте підписками зі свого сайту або бота.
Партнерський API дає змогу створити власний сайт, кабінет клієнта або бота поверх CreateYourVPN. Він відкриває лише клієнтів, тарифи й підписки; сервери, вузли, панелі та інфраструктурні облікові дані ніколи не потрапляють у відповіді.
Ключ призначений лише для взаємодії сервер–сервер. Не додавайте його до JavaScript або мобільного застосунку. Запити, схожі на браузерні, відхиляються з 403 browser_forbidden.
Початок роботи
- Відкрийте в панелі Налаштування → API та інтеграції.
- Створіть ключ із мінімальними правами та скопіюйте секрет; його показують лише один раз.
- Надсилайте ключ як
Authorization: Bearer cyv_live_…абоX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Права: config:read для конфігурації та локацій, users:read для читання клієнтів і users:write для створення клієнтів та керування підписками.
Публічний контракт
Публічна колекція Postman містить усі ендпоїнти, параметри, тіла запитів, приклади, права й коди помилок. Вона генерується з backend-контракту та є єдиним технічним джерелом істини.
Ліміти: 120 запитів на хвилину на ключ і 10 на хвилину для GET /users. grant, rotate і DELETE потребують Idempotency-Key; протягом 24 годин використовуйте те саме значення для повторів однієї події.
Відновлення з копії
Два способи повернути користувачів: відновлення в один клік із панелі, що ідемпотентно імпортує їх наново, або ручне відновлення в «чистий» Marzban, адже файл має нативний формат користувачів Marzban.
Аварійний доступ
Запасний спосіб підключитися, коли мережа працює за білими списками, а основне з'єднання заблоковано: створіть відеодзвінок, передайте нам посилання на нього з кабінету або поштою й отримайте готове підключення.