OpenAPI articles
API contract design, schema discipline, documentation structure, and integration-ready interface design.
All OpenAPI articles
Published posts in this category
OpenAPI Breaking Changes มีอะไรบ้าง และกันยังไงก่อนขึ้น production
อธิบายว่า breaking changes ใน OpenAPI มีอะไรบ้าง ทำไมหลายอย่างดูเล็กแต่กระทบ client จริง และควรใช้ contract checks, release discipline และ versioning อย่างไรเพื่อกันปัญหาก่อนขึ้น production
OpenAPI Validation ใน Express ควรอยู่ตรงไหนของ flow
อธิบายว่า OpenAPI validation ในระบบ Express ควรอยู่ตรงไหนของ request flow ควรตรวจอะไรบ้าง และทำไมการแยก contract validation ออกจาก business logic ถึงช่วยให้ระบบ production เสถียรขึ้น
API Versioning ควรใช้ path, header หรือ date-based แบบไหนดี
อธิบายข้อดีข้อเสียของการทำ API versioning แบบ path, header และ date-based ว่าแต่ละแบบเหมาะกับสถานการณ์ใด และควรตัดสินใจอย่างไรไม่ให้ contract ของระบบโตแล้วดูแลยาก
Webhook vs Polling vs WebSocket ควรเลือกแบบไหนในระบบจริง
อธิบายความต่างระหว่าง webhook, polling และ WebSocket ว่าแต่ละแบบเหมาะกับงานประเภทไหน มีข้อแลกเปลี่ยนอะไรใน production และควรตัดสินใจอย่างไรให้สอดคล้องกับลักษณะระบบจริง
OpenAPI สำหรับงานจริง: ออกแบบ API แบบ contract-first ให้ทีมคุยกันรู้เรื่อง
อธิบายการใช้ OpenAPI ในงานจริงแบบเป็นระบบ ตั้งแต่การออกแบบ schema, request/response contract, validation, versioning, documentation และตัวอย่างใช้งานกับ Node.js/Express