OpenAPI și llms.txt
Descrieri ale API-ului lizibile de mașină.
Două fișiere descriu API-ul în formă lizibilă de mașină: openapi.json pentru generatoare de cod și clienți API, llms.txt pentru agenți AI.
openapi.json
Specificația în format OpenAPI 3.0 descrie endpointurile cu parametrii principali, răspunsurile, erorile și autentificarea. Acoperă și evenimentele pe care le livrează webhookurile. Pentru orice detaliu, această documentație este cea de referință.
https://handelsregister.ai/openapi.json
Cum o folosești:
- Cu un generator precum OpenAPI Generator creezi un client tipizat pentru limbajul tău.
- Importă fișierul în Postman, Insomnia sau Bruno și ai imediat toate cererile la îndemână.
- Frameworkurile de agenți construiesc din fișier definiții de instrumente pentru un model de limbaj.
Deschide URL-ul în browser, salvează fișierul și importă-l.
llms.txt
llms.txt rezumă API-ul ca text scurt pentru modelele de limbaj: endpointuri, parametri, funcții, prețuri și cele mai importante reguli.
https://handelsregister.ai/llms.txt
Dă URL-ul agentului tău AI înainte să scrie cod pentru API. Astfel cunoaște numele reale ale parametrilor și câmpurile răspunsului.