# 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` |