design Archive

คำแนะนำในการออกแบบ API ที่ดี

จากการสอนและแนะนำเรื่องการออกแบบ API (Application Programming Interface) ที่ดีไม่ว่าจะเป็น code ไม่ว่าจะเป็น RESTFul API ก็ตามAPI เหล่านั้นควรมีคุณสมบัติต่าง ๆ ดังนี้ ออกแบบในมุมมองของคนใช้งาน ไม่ใช่มุมมองขอคนสร้าง ง่ายต่อการเรียนรู้และใช้งาน โดยเอกสารเป็นสิ่งสุดท้ายที่ควรอ่าน ยากต่อการใช้งานผิด ง่ายต่อการดูแลรักษาในระดับ code ซึ่งทำให้พัฒนาและต่อยอดได้ง่าย ต้องมีความสัมพันธ์กับความต้องการต่าง ๆ

Read More…

อย่าลืมจัดการกับ Error response ของ API นะ มันสำคัญมาก ๆ

เนื่องจากช่วงนี้ต้องไปร่วมพัฒนาระบบงานที่มี RESTful APIs ให้บริการ พบว่าสิ่งหนึ่งสำหรับนักพัฒนาที่ดีจะต้องคำนึงถึงก็คือ การจัดการกับ error หรือข้อผิดพลาดต่าง ๆ ซึ่งถ้าจัดการได้ดี จะทำให้ API ที่สร้างนั้นมันดูดีมากขึ้น เนื่องจากสิ่งที่สร้างนั้น เพื่อให้คนใช้งานนะ ดังนั้นการออกแบบสำหรับการจัดการข้อมูลพลาดจึงสำคัญมาก ๆ จึงทำการสรุปเรื่องที่ต้องใส่ใจไว้ดังนี้

Read More…

Developer ควรลดความซับซ้อนของ code ลงบ้างนะ

ช่วงนี้ว่างจากงาน เลยนั่งเขียนระบบงานเอาไว้ใช้เอง ซึ่งเป็นระบบ CRM เล็ก ๆ ง่าย ๆ โดยมี requirement ดังต่อไปนี้ การจัดการข้อมูลบริษัทที่ทำงานด้วย การจัดการชื่อผู้ติดต่อของแต่ละบริษัท การจัดการเรื่องสัญญาการทำงานของแต่ละบริษัท ประกอบไปด้วย การ training, coaching, consuling และ project มาเริ่มพัฒนาในส่วนของ Entity ดีกว่า

Read More…

ค่าใช้จ่ายที่มากับ source code

ปัจจุบัน developer ต้องทำงานกับ code แบบไหนกันนะ ? ทำงานกับ legacy code, ugly code หรือ beautiful code กันอยู่นะ ? จากที่ทำงานมานั้น มักจะอยู่กับ ugly code มากกว่านะ ซึ่งมันไม่น่าจะใช่เรื่องปกติของการพัฒนา software หรือเปล่านะ ? คำถามที่มักได้ยินมาตลอดคือ แล้วเราควรที่จะ rewrite หรือ refactor มันดีล่ะ

Read More…

ทำความเข้าใจกับปัญหา N + 1

พี่ @roofimon ส่งบทความเรื่อง Web API and N+1 problem มาให้อ่าน เป็นเรื่องที่น่าสนใจมาก จึงทำการสรุปหน่อยดีกว่า ดังนั้นมาทำความรู้จักและเข้าใจกับ ปัญหา N+1 กัน นั่นใจว่าเป็นปัญหาที่ทุกๆ คนเห็นหรือทำอยู่เป็นประจำ

Read More…