57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# Nubes API Reference
|
||
|
||
## ⛔ Актуальный API — ТОЛЬКО Gateway (lk-api-gateway)
|
||
|
||
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 (JSON идентичен).
|
||
|
||
## Токены
|
||
|
||
| Стенд | Файл | Формат |
|
||
|---|---|---|
|
||
| DEV | `secrets/dev.token` | JWT, ~1387 байт |
|
||
| TEST | `secrets/test.token` | JWT, ~1387 байт |
|
||
| PROD | `secrets/prod.token` | JWT, ~1387 байт |
|
||
|
||
## Важно
|
||
|
||
- Новый gateway **не поддерживает** `?endpoint=` — только REST-пути
|
||
- Старый `index.cfm` с `?endpoint=` — работает, используется провайдером v5.0.75
|
||
- Переход на новый gateway потребует переделки URL-роутинга в провайдере
|
||
- `.deck.nubes.ru` домены **не работают** — только `.ngcloud.ru`
|
||
|
||
## DNS
|
||
|
||
| Хост | IP |
|
||
|---|---|
|
||
| `*.ngcloud.ru` (все API) | `185.178.210.252` |
|