svc-api: переход на Gateway (lk-api-gateway), User-Agent+Referer для DDoS-Guard, метод Виталия /instanceOperations/default/{id} с dataDescriptor, LEGACY-пометки везде

docs/howitwasdone.md

@@ -1,3 +1,5 @@
+<!-- ⛔⛔⛔ LEGACY: deck-api.ngcloud.ru ЗАКРЫВАЕТСЯ! Все примеры ниже — ИСТОРИЧЕСКИЕ. -->
+<!-- Актуальный API: https://lk-api-gateway.ngcloud.ru/api/v1/svc -->
 # How It Was Done — Developer Guide (закрытая страница)
 
 **Filename & Versioning:** howitwasdone.md / 2026‑02‑04 / Draft v1
@@ -76,6 +78,25 @@
 ## 2. База знаний ошибок
 
 ### A. Аутентификация и токены
+
+**Токены лежат в `secrets/{dev,test,prod}.token`. Срок действия — до декабря 2026.**
+Проверить дату JWT:
+```bash
+python3 -c "import json,base64; t=open('secrets/test.token').read().split('.'); d=json.loads(base64.urlsafe_b64decode(t[1]+'==')); from datetime import datetime,timezone; print(datetime.fromtimestamp(d['exp'],tz=timezone.utc))"
+```
+
+**Симптом:** 403 Forbidden (НЕ 401!)
+**Причина (старый API index.cfm):** DDoS-Guard блокирует — нет Referer или нет User-Agent.
+**Решение для curl (старый API):**
+```bash
+curl -s --max-time 10 \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36" \
+  -H "Referer: https://deck-test.ngcloud.ru/" \
+  "https://deck-api-test.ngcloud.ru/api/v1/index.cfm?endpoint=/services/90"
+```
+Referer должен совпадать со стендом (test/dev/prod). Новый Gateway (lk-api-gateway) требует только Authorization.
+
 **Симптом:** 401 Unauthorized / Authorization header expected
 **Причина:** токен истёк или не передан в окружение
 **Решение:** обновить access_token и сохранить в файле HH‑MM‑SS.token; убедиться, что Terraform читает токен