Разработчикам

REST API, вебхуки и типизированный клиент

Схема OpenAPI генерируется из кода, клиент на TypeScript - из схемы. Ключи ограничены правами, проверочный ключ работает в песочнице и никогда не создаёт серверы. Суммы приходят строками: клиент не считает деньги.

Быстрый старт

Три шага до первого вызова

01Создайте ключ в панели администратора и выберите права: чтение, счета, услуги, обращения.

02Проверьте вызовы проверочным ключом: ответы настоящие, изменения не применяются.

03Подпишитесь на вебхуки и переключите ключ на живой режим.

OpenAPI 3.1 idempotency-key cursor pagination OIDC

$ curl https://api.panaceum.cc/v1/services/8421 \

-H "Authorization: Bearer pn_live_…"

{

"id": 8421,

"state": "active",

"provisioner": "pterodactyl",

"next_due_date": "2026-08-04",

"recurring_amount": "1081.92",

"currency": "RUB"

}

// вебхук: оплата счёта

POST /your-endpoint

X-Panaceum-Signature: sha256=…

{

"event": "invoice.paid",

"invoice_id": 10482,

"paid_at": "2026-07-04T09:12:03Z",

"gateway": "tbank"

}

Ресурсы

Что доступно в API

Клиенты

Чтение и изменение учётных записей, контактов и налоговых реквизитов.

Услуги

Состояние, тариф, даты продления, смена лимитов и запуск задач выдачи серверов.

Счета и платежи

Создание счёта, строки, комиссии, отметка об оплате и возвраты.

Обращения

Создание, ответ, изменение состояния и вложения.

Каталог

Продукты, группы, дополнения, цены и правила наценки.

Отчёты

Выгрузки по выручке, задолженности и загрузке узлов.

Правила

Как устроен доступ

Ключи и права

Ключ выдаётся под задачу: только чтение, только счета, только обращения. Права видны в панели.

Идемпотентность

Повторный вызов с тем же ключом операции не создаёт дубликат.

Ограничение частоты

Лимиты на ключ с заголовками остатка, при превышении - ответ 429 и время ожидания.

Журнал вызовов

Каждый вызов записан: ключ, метод, объект, результат и время.

Нужен доступ к тестовому контуру

Выдадим ключ песочницы и схему OpenAPI - можно проверить интеграцию до внедрения.