API сервера лицензий - документация SecurityFlow

Три открытых метода. Их вызывает Core, а для проверки ключа их можно вызвать и вручную. Адрес сервера: https://securityflow.ru.

Активация ключа

POST /api/v1/license/activate/

Принимает JSON. Пробелы и переносы строк в ключе вырезаются.

curl -s -X POST https://securityflow.ru/api/v1/license/activate/ \
  -H 'Content-Type: application/json' \
  -d '{"license_key": "<ключ>"}'

Успех, 200:

{
  "result": true,
  "status": "activated",
  "detail": "Лицензия активирована",
  "license_id": "…",
  "type": "paid",
  "expires_at": "2027-10-10T00:00:00+00:00"
}

Отказ, 400: result: false, причина в detail.

`detail`	Причина
Не передан ключ лицензии	пустое поле `license_key`
Лицензия не найдена	такого ключа на сервере нет
Лицензия отозвана	ключ отключён в кабинете
Срок лицензии истёк	срок вышел

Проверка ключа

GET /api/v1/license/status/?license_key=<ключ> или POST с тем же JSON, что у активации.

{
  "is_valid": true,
  "state": "active",
  "type": "paid",
  "license_id": "…",
  "valid_to": "2027-10-10T00:00:00+00:00",
  "activated_at": "2026-10-10T09:00:00+00:00"
}

Код	Что значит
200	ключ найден, действует ли он - в `is_valid`, состояние - в `state`: `active`, `expired`, `revoked`
400	ключ не передан
404	ключа на сервере нет

Core вызывает этот метод периодически. На is_valid: false и на 404 он снимает лицензию, на ошибку сервера - нет.

Открытый ключ

GET /api/public-key - открытый ключ, которым Core проверяет подпись лицензий.

curl -s https://securityflow.ru/api/public-key

Ограничения

Если на сервере включён белый список, API отвечает только адресам из списка, остальным - 403.
Сайт и документация белым списком не закрываются.