From 76f0b82c963d6809e7afc7ad2e28dee1c10c9686 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Wed, 1 Jul 2026 20:21:32 +0400
Subject: [PATCH] =?UTF-8?q?docs:=20API=20reference=20=E2=80=94=20old=20dec?=
 =?UTF-8?q?k-api=20+=20new=20lk-api-gateway?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 secrets/stands.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 secrets/stands.md

diff --git a/secrets/stands.md b/secrets/stands.md
new file mode 100644
index 0000000..0daf7f7
--- /dev/null
+++ b/secrets/stands.md
@@ -0,0 +1,53 @@
+# Nubes API Reference
+
+## Старый API (deck-api) — работает, проверено 2026-07-01
+
+Формат: `?endpoint=/instances&page=1&size=...`
+
+| Стенд | 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 идентичен).
+
+## Токены
+
+| Стенд | Файл | Формат |
+|---|---|---|
+| 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` |