OpenAPI 3.1 a Swagger UI

Strojovo-čitateľnú špecifikáciu API generujeme priamo zo Zod schém, takže vždy zodpovedá produkčnému API. Spec môžeš použiť na generovanie SDK, type-safe klientov, alebo na validáciu requestov v CI.

OpenAPI 3.1 JSON

Verejný endpoint, bez autentifikácie:

curl https://monivio.sk/api/v1/openapi.json

Cache-Control je public, max-age=300 – môžeš ho fetchovať priamo z CI pipeliny.

Swagger UI

Pre rýchle vyskúšanie máme aj klasické Swagger UI s "Try it out" tlačidlom – stačí v hornom rohu vyplniť svoj API kľúč a posielať requesty priamo z prehliadača:

Generovanie klienta

Vďaka štandardnej OpenAPI 3.1 môžeš vygenerovať type-safe klienta v ľubovoľnom jazyku. Najpoužívanejšie generátory:

TypeScript

# openapi-typescript – ľahká verzia (len typy)
npx openapi-typescript https://monivio.sk/api/v1/openapi.json -o monivio.d.ts

# alebo openapi-fetch (typy + fetch wrapper)
npx openapi-typescript https://monivio.sk/api/v1/openapi.json -o ./api/types.ts

Python

pip install openapi-python-client
openapi-python-client generate --url https://monivio.sk/api/v1/openapi.json

PHP

# OpenAPI Generator
npx @openapitools/openapi-generator-cli generate \
  -i https://monivio.sk/api/v1/openapi.json \
  -g php \
  -o ./monivio-php-client

Go

npx @openapitools/openapi-generator-cli generate \
  -i https://monivio.sk/api/v1/openapi.json \
  -g go \
  -o ./monivio-go-client

Postman / Insomnia

Importuj OpenAPI JSON priamo do Postmana (Import → Link) alebo Insomnia (Import → URL) – kolekcia sa vytvorí automaticky aj s authentifikáciou.