OpenAPI spec ของคุณคือสัญญา เมื่อมันไม่สอดคล้องกัน ไคลเอนต์จะเสีย, mock จะล้าสมัย, และการทดสอบอาจผ่านกับ API ที่ไม่มีอยู่จริงอีกต่อไป วิธีจัดการที่ปลอดภัยคือปฏิบัติต่อ spec เหมือนโค้ด: เก็บใน Git, แตก branch, เปิด PR, review diff, และ validate ทุกครั้งก่อน merge
ลองใช้ Apidog วันนี้
คู่มือนี้อธิบายวิธีควบคุมเวอร์ชัน OpenAPI ด้วย Git แบบใช้งานจริง ตั้งแต่ตำแหน่งไฟล์, กลยุทธ์ branch, checklist สำหรับ review, การ commit/push จาก Apidog, ไปจนถึง CI validation เพื่อให้ทีมมี workflow ที่ตรวจสอบได้และเชื่อถือได้
ทำไมต้องควบคุมเวอร์ชัน OpenAPI spec ของคุณ
spec ที่อยู่ใน wiki หรือ shared drive ไม่มีประวัติที่ดีพอ คุณจะตอบได้ยากว่าใครเปลี่ยน payload ของ POST /orders เมื่อไหร่ และเปลี่ยนเพราะอะไร Git แก้ปัญหานี้ได้โดยทำให้ spec กลายเป็น artifact ที่ตรวจสอบย้อนหลังได้
