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.