2026-05-18 · 1 मिनट पढ़ाई
हर release से पहले OpenAPI validate करें
टूटे contracts जल्दी पकड़ें — missing paths, info blocks, या version drift।
OpenAPIAPICI
मुख्य बिंदु
- Structural validation response schema tests का substitute नहीं — लेकिन obvious ship-stoppers रोकता है।
- प्रति service एक canonical spec file रखें; वही artifact validate करें जो publish करते हैं।
CI में validate क्यों
Broken specs codegen, documentation portals, और API gateways को cascade failures में तोड़ते हैं।
Quick structural pass घंटे बचाता है जब missing paths object production docs में ship हो।
Workflow
Feature branches merge के बाद JSON या YAML OpenAPI Validator में paste करें।
Valid हो तो same base URL और auth से HTTP Request से critical paths spot-check करें।
अक्सर पूछे जाने वाले प्रश्न
क्या यह response examples validate करता है?
यह top-level contract shape check करता है; payload examples और status codes के लिए contract tests जोड़ें।
Swagger 2.0 support?
Basic structural checks लागू होते हैं; संभव हो तो OpenAPI 3 पर migrate करें।