APIv2 developer portal
● dev environment corp-online.com

APIv2 · корпоративный шлюз

Унифицированный REST API для автоматизации, интеграции и управления сервисами.
Документация в разработке — примеры запросов готовы к использованию.

🔌 base URL: https://apiv2-dev.corp-online.com/api/v2
GET /status
Проверка работоспособности API, возвращает версию и состояние сервисов.
curl -X GET https://apiv2-dev.corp-online.com/api/v2/status \ -H "Authorization: Bearer {token}"
POST /auth/token
Получение access-токена для работы с API (client_credentials).
curl -X POST https://apiv2-dev.corp-online.com/api/v2/auth/token \ -H "Content-Type: application/json" \ -d '{"client_id":"your_client","client_secret":"****"}'
GET /users
Список пользователей организации (пагинация: limit, offset).
curl -X GET "https://apiv2-dev.corp-online.com/api/v2/users?limit=10&offset=0" \ -H "Authorization: Bearer {token}"
POST /service/call
Создание новой заявки на обслуживание (тикета).
curl -X POST https://apiv2-dev.corp-online.com/api/v2/service/call \ -H "Authorization: Bearer {token}" \ -H "Content-Type: application/json" \ -d '{"subject":"Проблема с VPN","priority":"high","description":"не проходит авторизация"}'
GET /health/infra
Метрики инфраструктуры: статус компонентов, задержки.
curl -X GET https://apiv2-dev.corp-online.com/api/v2/health/infra \ -H "Authorization: Bearer {token}"
DELETE /cache/flush
Сброс кэша для указанного модуля (требует прав администратора).
curl -X DELETE https://apiv2-dev.corp-online.com/api/v2/cache/flush \ -H "Authorization: Bearer {token}" \ -d '{"target":"session"}'

📘 Примеры ответов (mock / dev mode)

✅ Успешный ответ (200)
{ "status": "ok", "data": { "message": "эндпоинт активен (dev-заглушка)", "timestamp": "2025-03-27T12:00:00Z" } }
🔐 Ошибка авторизации (401)
{ "error": "invalid_token", "description": "Missing or expired JWT", "status_code": 401 }
🔑 Тестовый токен (sandbox): eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJkZXZfdXNlciIsInJvbGUiOiJkZXZlbG9wZXIifQ.fake-signature-dev

💡 Все примеры — интерактивная демонстрация. В режиме разработки API возвращает статический мок-ответ, структура соответствует реальному APIv2.