fix(docs,security): Swagger UI — staging для exploration, prod env-flagged

docs/integration/api/read-endpoints.md

@@ -14,13 +14,22 @@ Base URL:
 
 ## OpenAPI / Swagger UI
 
-Interactive playground с **Keycloak login** (PKCE flow, без client_secret):
+Interactive playground с **Keycloak login** (PKCE flow, без client_secret).
 
-- **Swagger UI:** `https://ordinis.k8s.264.nstart.cloud/swagger-ui.html`
+**Используй staging для exploration, не prod.** Прод — для реальных
+пользователей и боевых данных. Запросы из Swagger UI создают
+audit-записи и могут менять данные если ты случайно нажмёшь POST/PUT/DELETE.
+
+- **Swagger UI (staging):** `https://ordinis.k8s.265.nstart.cloud/swagger-ui.html`
   → нажми **Authorize** → выбери `oauth2` → войдёшь через Keycloak.
   После login каждый "Try it out" автоматически добавит JWT.
-- **Spec JSON:** `https://ordinis.k8s.264.nstart.cloud/v3/api-docs`
-- **Spec YAML:** `https://ordinis.k8s.264.nstart.cloud/v3/api-docs.yaml`
+- **Spec JSON (staging):** `https://ordinis.k8s.265.nstart.cloud/v3/api-docs`
+- **Spec YAML (staging):** `https://ordinis.k8s.265.nstart.cloud/v3/api-docs.yaml`
+
+OpenAPI spec для clients (SDK generation, code-first integration) можно
+также pull from prod (`/v3/api-docs` на k8s.264) — это статичный файл,
+безопасный для machine consumption. Для interactive exploration — только
+staging.
 
 {% note tip %}