Versiunea AI (llms.txt)

ProxyHat publică copii ale acestei documentații într-un format care poate fi citit automat, astfel încât asistenții AI să poată citi și înțelege API-ul direct. Dacă folosești Claude, Cursor, Codex sau orice alt instrument bazat pe LLM pentru a-ți construi integrarea, dă-i aceste fișiere și va avea imaginea completă și exactă a API-ului, fără să ghicească.

Cele două fișiere

Index de linkuri — un fișier Markdown scurt care listează fiecare pagină de documentație, cu un rezumat de un rând și URL-ul ei. Suficient de mic încât să rămână permanent în contextul unui asistent; modelul preia paginile individuale la cerere.

Documentația completă — toate paginile concatenate într-un singur document Markdown. Niciun link de urmat, nimic de preluat: îl lipești o dată și asistentul cunoaște întregul API.

Cum îl folosești cu instrumentul tău

Două abordări funcționează peste tot:

• Lipește-l. Apasă „Copiază pentru AI” mai sus (sau deschide https://docs.proxyhat.com/llms-full.txt și copiază tot fișierul), apoi lipește-l în chatul asistentului tău sau într-un fișier de context/reguli. Cea mai bună variantă când instrumentul tău nu are acces la internet.
• Indică-i URL-ul. Dă-i instrumentului tău URL-ul https://docs.proxyhat.com/llms.txt sau https://docs.proxyhat.com/llms-full.txt și lasă-l să-l preia. Cea mai bună variantă pentru instrumente cu acces web sau de preluare a fișierelor.

Note specifice fiecărui instrument

• Claude / Claude Code — lipește conținutul lui llms-full.txt în conversație sau adaugă URL-ul în CLAUDE.md din proiectul tău, ca fiecare sesiune să-l preia automat. Claude Code poate, de asemenea, să acceseze URL-ul direct cu instrumentele lui web.
• Codex — pune URL-ul sau conținutul lipit în AGENTS.md (sau în prompt), astfel încât agentul să-l consulte în timp ce îți scrie integrarea.
• Cursor — adaugă https://docs.proxyhat.com/llms-full.txt la Settings → Indexing & Docs (Add new doc) sau lipește fișierul într-un .cursorrules / o regulă de proiect.
• Kimi — lipește conținutul lui llms-full.txt în chat sau trimite-i URL-ul și roagă-l să citească mai întâi fișierul.
• OpenCode — referențiază URL-ul în configurația agentului / fișierul de reguli sau lipește fișierul complet în context.
• Orice alt LLM — regula e aceeași: folosește butonul „Copiază pentru AI”, lipește conținutul lui llms-full.txt în asistentul tău sau indică-i instrumentului URL-urile de mai sus.

Ce va învăța AI-ul

Din aceste fișiere un asistent obține tot ce îi trebuie ca să scrie o integrare funcțională, inclusiv:

• URL-ul de bază — fiecare cerere merge la https://api.proxyhat.com/v1.
• Autentificarea — cum obții o cheie API și cum o trimiți ca Authorization: Bearer <key>.
• Modelul de sub-utilizatori — cum se mapează sub-utilizatorii, grupurile și preseturile pe accesul la proxy-uri.
• Șirurile de conectare la proxy — gramatica numelui de utilizator (țară, sesiune, rotație și targetare cu filtru AI) și cum construiești sau preiei un șir de conectare gata de folosit.
• Fluxul de reseller — provizionarea și administrarea proxy-urilor în numele propriilor tăi clienți.
• Formatele răspunsurilor — care endpointuri folosesc structura standard {success, payload, meta, errors, description} și care returnează obiecte plate, cu numele reale ale câmpurilor peste tot.