Versione AI (llms.txt)

ProxyHat pubblica copie leggibili dalle macchine di questa documentazione, così gli assistenti AI possono leggere l'API e ragionarci sopra direttamente. Se usi Claude, Cursor, Codex o qualsiasi altro strumento basato su LLM per costruire la tua integrazione, passagli questi file: avrà un quadro completo e accurato dell'API, senza tirare a indovinare.

I due file

Indice dei link — un breve file Markdown che elenca ogni pagina della documentazione con un riassunto di una riga e il relativo URL. Abbastanza piccolo da restare in modo permanente nel contesto di un assistente; il modello recupera le singole pagine su richiesta.

Documentazione completa — tutte le pagine concatenate in un unico documento Markdown. Nessun link da seguire, niente da scaricare: lo incolli una volta e l'assistente conosce l'intera API.

Come usarlo con il tuo strumento

Due approcci funzionano ovunque:

• Incollalo. Fai clic su “Copia per l'AI” qui sopra (oppure apri https://docs.proxyhat.com/llms-full.txt e copia l'intero file), poi incollalo nella chat del tuo assistente o in un file di contesto/regole. Ideale quando il tuo strumento non ha accesso a internet.
• Punta all'URL. Fornisci al tuo strumento l'URL https://docs.proxyhat.com/llms.txt o https://docs.proxyhat.com/llms-full.txt e lascia che lo recuperi da solo. Ideale per gli strumenti con accesso al web o al recupero di file.

Note specifiche per strumento

• Claude / Claude Code — incolla il contenuto di llms-full.txt nella conversazione, oppure aggiungi l'URL al CLAUDE.md del tuo progetto, così ogni sessione lo caricherà automaticamente. Claude Code può anche recuperare l'URL direttamente con i suoi strumenti web.
• Codex — inserisci l'URL o il contenuto incollato nel tuo AGENTS.md (o nel prompt), così l'agente potrà consultarlo mentre scrive la tua integrazione.
• Cursor — aggiungi https://docs.proxyhat.com/llms-full.txt in Settings → Indexing & Docs (Add new doc), oppure incolla il file in un .cursorrules / in una regola di progetto.
• Kimi — incolla il contenuto di llms-full.txt nella chat, oppure condividi l'URL e chiedigli di leggere prima il file.
• OpenCode — fai riferimento all'URL nel file di configurazione/regole del tuo agente, oppure incolla il file completo nel contesto.
• Qualsiasi altro LLM — la regola è la stessa: usa il pulsante “Copia per l'AI”, incolla il contenuto di llms-full.txt nel tuo assistente oppure punta il tuo strumento agli URL indicati sopra.

Cosa imparerà l'AI

Da questi file un assistente ricava tutto ciò che gli serve per scrivere un'integrazione funzionante, tra cui:

• URL di base — ogni richiesta va a https://api.proxyhat.com/v1.
• Autenticazione — come ottenere una chiave API e inviarla come Authorization: Bearer <key>.
• Il modello dei sub-user — come sub-user, gruppi e preset si mappano sull'accesso ai proxy.
• Stringhe di connessione proxy — la grammatica dello username (paese, sessione, rotazione e targeting con filtro AI) e come costruire o recuperare una stringa di connessione pronta all'uso.
• Il flusso reseller — provisioning e gestione dei proxy per conto dei tuoi clienti.
• Struttura delle risposte — quali endpoint usano l'envelope standard {success, payload, meta, errors, description} e quali restituiscono oggetti piatti, con i nomi reali dei campi ovunque.