Документация для ИИ

Готовые файлы, которые можно скормить Cursor, ChatGPT, Claude и другим ассистентам, чтобы они сразу вызывали Проксюшу правильно — без выдуманных URL и смешанных ключей.

Что дать ассистенту

/llms.txt

Короткий индекс (стандарт llms.txt): что это за сервис и куда читать дальше.

Открыть
/llms-full.txt

Полный machine-readable гайд: auth, routing, endpoints, рецепты, checklist.

Открыть
/agents.md

Короткие правила для coding agents (Cursor и аналоги).

Открыть
Промпт

Вставьте блок ниже в чат с ассистентом вместе с вашим BASE и ключом.

copy-paste

Промпт для вставки

Ты помогаешь интегрировать Proksusha (goproxy) — HTTP gateway, не VPN.

Сначала прочитай каноничный гайд:
https://proksusha.ru/llms-full.txt
(краткие правила: https://proksusha.ru/agents.md)

Мои креды:
BASE=https://ru.proksusha.ru
KEY=pk_live_...

Правила:
1) Ключ шлюза только в X-Api-Key.
2) Секреты upstream только в X-Upstream-* (не смешивать с pk_live_).
3) Для API — /v1/proxy, для файлов — /v1/fetch, CDN — /o/{slug}, вебхуки — /in/{token}.
4) По умолчанию маршрут X-Chain: ru->de, если я не сказал иначе.
5) Логи по умолчанию выкл. Включить: PATCH /v1/me/settings { "logging_enabled": true }. Затем (JWT, только последние 20): GET /v1/logs?key_id=…, GET /v1/logs?node=… или GET /v1/nodes/{id}/logs.
6) Не вызывай /internal/*.
7) Пиши рабочий код под мой язык и сразу готовые команды.

Что ассистент обязан знать

Для людей удобнее страницы Примеры и API. Для моделей — llms-full.txt.