OpenAPI 3.0 spec'inin ham YAML icerigi
GET/openapi.yaml
Bu API'nin OpenAPI 3.0 spec'ini ham YAML olarak doner. Auth gerektirmez — endpoint listesi ve schema'lar dokuman karakteri tasir, gizli degil.
Kullanim alanlari:
- Dev test paneli (
/dev/docs.html) Swagger UI ile bunu render eder. - Postman / Insomnia gibi araclara import.
- SDK / istemci kodu jeneratorleri (openapi-generator vb.).
Cache: ETag + 5 dakika Cache-Control: public, max-age=300. Spec
siklikla degismez; tarayici 304 Not Modified ile ucuz cevap alir.
Responses
- 200
- 304
- 404
OpenAPI 3.0 spec'inin YAML icerigi
Response Headers
ETag
16 karakterli MD5 prefix; If-None-Match ile 304 dondurmek icin kullanilir.
Cache-Control
Spec degismedi (If-None-Match esleslti). Body bos.
docs/openapi.yaml dosyasi sunucuda bulunamadi (deploy hatasi)