swagger Archive

สรุปการแบ่งปันเรื่อง API-First development (Design-First)

มีโอกาสแบ่งปันประสบการณ์เรื่องของ API-First development (Design-First)ซึ่งจะตรงข้ามกับ Code-First ที่มักจะมีขั้นตอนการทำงานดังนี้ แต่แนวทางของ API-First development จะแตกต่างออกไปดังนี้

Read More…

สรุปการพูดคุยเรื่อง Swagger/Protobuf usecase and trend

วันนี้ได้พูดคุยใน ClubHouse กันนิดหน่อย เรื่อง Swagger/Protobuf usecase and trendเป็นการแลกเปลี่ยนแนวทางในการพัฒนา API ไม่ว่าจะเป็น RESTFul API, Protobuf หรือพวก gRPC แนวทางในการพูดคุยประกอบไปด้วย

Read More…

แนวทางการพัฒนา REST API และ API Documentation

จากบทความเรื่อง รวม Tips & Tricksในการสร้าง Swagger UI ให้กับ Gin REST API ด้วย Swaggoอธิบายถึงการสร้าง API Documentationโดยทำการสร้างมาจาก Code Annotation ในส่วนของ comment ด้วย command swagซึ่งเป็นแนวทางหนึ่งในการสร้างเอกสารขึ้นมา แต่ก็ยังไม่แนวทางอื่น ๆ ใช้งานเช่นกัน

Read More…

VS Code :: ใช้งาน Open API หรือ Swagger Editor ได้แล้ว

สำหรับใครที่ต้องออกแบบและจัดการ Open API หรือ Swagger แล้ว ใน VS Code นั้นมี extension ชื่อว่า OpenAPI (Swagger) Editor ให้ใช้งาน แน่นอนว่า ทำให้การทำงานง่ายและสะดวกขึ้น

Read More…

[Python]สร้าง API ง่าย ๆ ด้วย Flask และ Connexion

วันนี้มีโอกาสได้แบ่งปันความรู้สำหรับการสร้าง API ด้วยภาษา Python โดยสิ่งที่ต้องการคือ พัฒนาได้ง่าย ยิ่งถ้าสร้างจาก specification บางอย่างด้วยน่าจะดี ขนาดไม่ใหญ่ ไม่ซับซ้อน ดังนั้นจึงเลือก Flask ซึ่งเป็น microframework สำหรับการพัฒนาระบบ web รวมทั้งใช้ Connexion เพื่อช่วยทำการสร้าง API แบบอัตโนมัติ จากการกำหนดค่าต่าง ๆ ในรูปแบบ OpenAPI หรือ Swagger Specification นั่นเอง ซึ่งน่าจะเป็นทางเลือกที่น่าสนใจ มาลองใช้งานกัน

Read More…