OpenAPI og llms.txt
Maskinlesbare beskrivelser av API-et.
To filer beskriver API-et i maskinlesbar form: openapi.json for kodegeneratorer og API-klienter, llms.txt for AI-agenter.
openapi.json
Spesifikasjonen i OpenAPI 3.0-formatet beskriver endepunktene med de viktigste parameterne, svarene, feilene og autentiseringen. Den dekker også hendelsene som webhooks leverer. For hver detalj er denne dokumentasjonen avgjørende.
URL
https://handelsregister.ai/openapi.json
Slik bruker du den:
- Med en generator som OpenAPI Generator lager du en typet klient for språket ditt.
- Importer filen i Postman, Insomnia eller Bruno, så har du alle forespørsler for hånden med en gang.
- Agentrammeverk bygger verktøydefinisjoner for en språkmodell ut fra filen.
Åpne URL-en i nettleseren, lagre filen og importer den.
Innenfor versjon 1 kommer nye felt og verdier til, og eksisterende blir værende. Bygg klienten din slik at den ignorerer ukjente felt. Mer i endringsloggen.
llms.txt
llms.txt oppsummerer API-et som en kort tekst for språkmodeller: endepunkter, parametere, funksjoner, priser og de viktigste reglene.
URL
https://handelsregister.ai/llms.txt
Gi URL-en til AI-agenten din før den skriver kode for API-et. Slik kjenner den de ekte parameternavnene og svarfeltene.