docs: Gateway API — списки сервисов, DDoS-Guard заголовки, метод Виталия
This commit is contained in:
+24
-21
@@ -1,34 +1,37 @@
|
||||
# Nubes API Reference
|
||||
|
||||
## Старый API (deck-api) — работает, проверено 2026-07-01
|
||||
## ⛔ Актуальный API — ТОЛЬКО Gateway (lk-api-gateway)
|
||||
|
||||
Формат: `?endpoint=/instances&page=1&size=...`
|
||||
DDoS-Guard требует 3 заголовка для ВСЕХ запросов:
|
||||
```bash
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
-H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36"
|
||||
-H "Referer: https://deck-{stand}.ngcloud.ru/"
|
||||
```
|
||||
|
||||
| Стенд | Gateway URL | Referer | Токен |
|
||||
|-------|-------------|---------|-------|
|
||||
| DEV | `https://lk-api-gateway-dev.ngcloud.ru/api/v1/svc` | `https://deck-dev.ngcloud.ru/` | `secrets/dev.token` |
|
||||
| TEST | `https://lk-api-gateway-test.ngcloud.ru/api/v1/svc` | `https://deck-test.ngcloud.ru/` | `secrets/test.token` |
|
||||
| PROD | `https://lk-api-gateway.ngcloud.ru/api/v1/svc` | `https://deck.ngcloud.ru/` | `secrets/prod.token` |
|
||||
|
||||
## Проверенные эндпоинты Gateway:
|
||||
|
||||
```
|
||||
GET /services — список всех сервисов
|
||||
GET /services/{svcId} — метаданные сервиса + операции
|
||||
GET /instanceOperations/default/{svcOperationId} — параметры с dataDescriptor и valueList (метод Виталия)
|
||||
```
|
||||
|
||||
## ⛔ Старый API (deck-api/index.cfm) — ЗАКРЫВАЕТСЯ, НЕ ИСПОЛЬЗОВАТЬ
|
||||
|
||||
Историческая справка:
|
||||
| Стенд | URL |
|
||||
|---|---|
|
||||
| DEV | `https://deck-api-dev.ngcloud.ru/api/v1/index.cfm` |
|
||||
| TEST | `https://deck-api-test.ngcloud.ru/api/v1/index.cfm` |
|
||||
| PROD | `https://deck-api.ngcloud.ru/api/v1/index.cfm` |
|
||||
|
||||
## Новый API Gateway (lk-api-gateway) — работает, проверено 2026-07-01
|
||||
|
||||
Формат: REST-пути (`/instances` вместо `?endpoint=/instances`)
|
||||
|
||||
| Стенд | URL |
|
||||
|---|---|
|
||||
| DEV | `https://lk-api-gateway-dev.ngcloud.ru/api/v1/svc` |
|
||||
| TEST | `https://lk-api-gateway-test.ngcloud.ru/api/v1/svc` |
|
||||
| PROD | `https://lk-api-gateway.ngcloud.ru/api/v1/svc` |
|
||||
|
||||
## Проверенные эндпоинты нового gateway
|
||||
|
||||
```
|
||||
GET /api/v1/svc
|
||||
GET /api/v1/svc/instances?page=1&size=...
|
||||
GET /api/v1/svc/instances/{instanceUid} (предположительно)
|
||||
POST /api/v1/svc/instances (предположительно)
|
||||
```
|
||||
|
||||
Данные возвращаются те же, что и в старом API (JSON идентичен).
|
||||
|
||||
## Токены
|
||||
|
||||
Reference in New Issue
Block a user