llms.txt |
Due strade, un'unica API. Incolla il nostro llms.txt in Cursor, Claude Code o ChatGPT — o costruisci app reali nel browser con Publishable Keys. Niente SDK, niente backend, niente CORS hell.
Copia. Incolla. Pubblica codice.
Incolla llms.txt in Cursor, Claude Code, Windsurf o ChatGPT — l'AI scrive integrazioni funzionanti.
App AI-Canvas con chiamate API vere.
Costruisci app React in un singolo file che chiamano la nostra API direttamente dal browser — in Claude Artifacts, ChatGPT Canvas, Gemini o Grok. Publishable Keys (po_pk_) in stile Stripe — scope limitato, budget bloccato, origine verificata.
Costruito per l'AI — non per Postman.
La Postman Collection è 1,5 MB di JSON ottimizzato per Postman/Insomnia/Bruno. llms.txt è Markdown puro — un formato che ogni LLM legge nativamente.
Postman Collection
~1.5 MBImporta in Postman, Insomnia, Bruno — test con un clic, debug, condivisione con il team.
Vai a Postman →llms.txt (Hub)
~53 KBIndice compatto — da incollare nell'AI per lookup rapidi e discovery degli endpoint.
llms.txt →llms-full.txt
~780 KBOgni endpoint con parametri, esempi di risposta ed error code — quello da incollare per integrazioni vere.
llms-full.txt →Esempi di prompt
Questi prompt funzionano in Claude, Cursor, Windsurf, ChatGPT, Gemini e ogni altra AI di coding.
Leggi questa documentazione API:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Scrivi una funzione Python che prende un file PDF e restituisce il testo OCR estratto.@Docs https://api.paperoffice.ai/latest/docs/llms-full.txt
Costruisci un endpoint FastAPI che classifica fatture caricate via /documentai/classify.Hai accesso all'API PaperOffice. La spec completa è qui:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Usa un token Bearer nell'header Authorization.Ogni AI parla llms.txt.
Il Markdown è la lingua madre degli LLM moderni. Butta l'URL in qualunque strumento che legge doc — senza estensioni né plugin.
Nessuna fiducia richiesta — le regole sono nella pietra.
Le Publishable Keys restano sicure anche se qualcuno le copia dal codice del tuo AI-canvas artifact.
Endpoint pericolosi bloccati
DELETE, admin, billing, webhooks e token-management — hardcoded-bloccati, indipendentemente dallo scope.
Budget cap immediato
Al raggiungimento del limite di crediti: HTTP 402 BUDGET_EXHAUSTED. Nemmeno un credito in più.
Rate limiting via Redis
Sliding-window per token. Superamento → HTTP 429.
Header Origin obbligatorio
Il browser lo imposta automaticamente. Abusi server-a-server di un po_pk_ fuoriuscito sono esclusi.
Revoke istantaneo
Clicca "Revoke" — la cache Redis viene invalidata subito. Chiave compromessa morta in millisecondi.
Scope granulari
Ogni scope si attiva/disattiva individualmente nella dashboard.
Da zero a codice funzionante in 30 secondi
Copia l'URL
Prendi llms-full.txt per la spec completa o llms.txt per un indice sottile.
Incolla nell'AI
Claude recupera le URL. Cursor ha @Docs. ChatGPT naviga.
Prompt e pubblica
L'AI capisce ogni endpoint, auth, pricing e codice di errore.
ReadyTutto quello che devi sapere sulle Publishable Keys.
Funziona davvero solo in Claude Artifacts?
No — po_pk_ funziona in ogni moderna piattaforma AI-Canvas: Claude Artifacts, ChatGPT Canvas, Gemini (Canvas & Gems), Grok Workspaces e ogni ambiente nel browser come v0.dev, Bolt.new, StackBlitz o CodeSandbox. Le quattro origini AI sono whitelistate di default; puoi registrare anche il tuo dominio.
In cosa po_pk_ è diverso da po_sk_?
po_sk_ (Secret Key) è pensato per l’integrazione server-to-server — accesso completo all’intera API, non inserirlo mai nel browser. po_pk_ (Publishable Key) è progettato per il codice del browser: limitato per ambito ai gruppi di endpoint esplicitamente consentiti, con un tetto di crediti a vita e blocco dell’origine. Un po_sk_ all’interno di un artefatto AI-canvas sarebbe una catastrofe totale — un po_pk_ è per progettazione limitato ai danni previsti.
Cosa succede se il mio po_pk_ diventa pubblico?
Il danno resta contenuto: lock di origine, budget cap, rate limiting. "Revoke" lo uccide istantaneamente.
Posso usare origini mie, tipo mia-azienda.com?
Sì. In fase di creazione puoi impostare una lista di origini permesse. Il preset WIDGET è pensato per questo.
Come imposto il budget di crediti?
Alla creazione scegli un limite a vita (default: 1.000, AIDEMO: 2.000, WIDGET: 5.000). Modificabile in qualsiasi momento.
po_pk_ viene fatturato in modo diverso da po_sk_?
No. Ogni chiamata API utilizza gli stessi crediti dal tuo account principale — sia tramite po_sk_, po_ut_ o po_pk_. Il limite di budget di po_pk_ è una protezione aggiuntiva, non un livello di prezzo separato.
Quali endpoint sono off-limits per po_pk_?
Tutti i metodi DELETE e ogni endpoint di amministrazione, fatturazione, webhook e gestione token sono bloccati in modo hardcoded — indipendentemente da ciò che selezioni nello scope. È quindi tecnicamente impossibile eliminare dati, leggere informazioni di fatturazione o creare nuovi token con un po_pk_.
Meno token, prompt meno costosi, zero boilerplate JSON — llms.txt è contenuto puro per ragionamento AI puro.
Pronto al prompt?
Copia, incolla, pubblica — nella tua IDE o direttamente nel browser. Due strade, un'unica API, senza lock-in.