กำลังเตรียมประสบการณ์ดิจิทัล
ก่อนจ้างพัฒนา API ธุรกิจไม่จำเป็นต้องเข้าใจเรื่องเทคนิค แต่ควรเตรียม 6 เรื่องให้ชัด คือ เป้าหมาย ระบบและข้อมูลที่มีอยู่ ผู้ที่จะเรียกใช้ ตัวอย่างข้อมูลจริง สิทธิ์และความปลอดภัย และคนดูแลหลังส่งมอบ เพราะงาน API คือการเชื่อมสิ่งที่มีอยู่แล้วเข้าหากัน ทีมพัฒนาจะประเมินงานได้แม่นก็ต่อเมื่อเห็นของจริง บทความนี้อธิบายแต่ละเรื่องว่าต้องเตรียมอะไร เตรียมได้แค่ไหนก็พอ และถ้าไม่เตรียมจะเกิดอะไรขึ้น
ก่อนจ้างพัฒนา API ธุรกิจไม่จำเป็นต้องเข้าใจเรื่องเทคนิค แต่ควรเตรียม 6 เรื่องให้ชัด คือ เป้าหมาย ระบบและข้อมูลที่มีอยู่ ผู้ที่จะเรียกใช้ ตัวอย่างข้อมูลจริง สิทธิ์และความปลอดภัย และคนดูแลหลังส่งมอบ เพราะงาน API คือการเชื่อมสิ่งที่มีอยู่แล้วเข้าหากัน ทีมพัฒนาจะประเมินงานได้แม่นก็ต่อเมื่อเห็นของจริง บทความนี้อธิบายแต่ละเรื่องว่าต้องเตรียมอะไร เตรียมได้แค่ไหนก็พอ และถ้าไม่เตรียมจะเกิดอะไรขึ้น
งาน API ต่างจากงานทำเว็บตรงที่ส่วนใหญ่ไม่มีหน้าจอให้ดู สิ่งที่ส่งมอบคือทางเชื่อมระหว่างระบบ ความยากจริงจึงอยู่ที่ระบบปลายทางที่ต้องไปเชื่อม ซึ่งทีมพัฒนาจากภายนอกมองไม่เห็นจนกว่าลูกค้าจะเปิดให้ดู ยิ่งเตรียมข้อมูลมาครบ ใบเสนอราคาจะยิ่งใกล้ความจริง และงานจะไม่ติดเพราะรอข้อมูลกลางทาง
เขียนเป็นประโยคธุรกิจ ไม่ต้องเป็นภาษาเทคนิค เช่น ให้ลูกค้าเช็กสถานะออเดอร์ใน LINE ได้เองโดยไม่ต้องทักแอดมิน หรือให้ยอดขายหน้าร้านเข้าโปรแกรมบัญชีอัตโนมัติทุกคืน แล้วบอกตัวเลขที่อยากเห็นหลังใช้งาน เช่น ลดเวลาคีย์ข้อมูลวันละสองชั่วโมง เป้าหมายที่ชัดช่วยให้ทีมพัฒนาตัดสิ่งที่ไม่จำเป็นออกตั้งแต่ต้น ถ้ายังไม่แน่ใจว่าธุรกิจถึงเวลาต้องมี API หรือยัง อ่าน<a href="article-what-is-api-when-business-needs">API คืออะไร ธุรกิจต้องมีเมื่อไร</a>ก่อนได้
ทำรายการว่าข้อมูลที่เกี่ยวข้องอยู่ที่ไหนบ้าง เช่น ระบบหลังบ้านที่เขียนเอง โปรแกรมสำเร็จรูป ไฟล์ Excel หรือบริการบนคลาวด์ แต่ละระบบใครเป็นผู้ดูแล มีช่องทางให้ดึงข้อมูลอยู่แล้วหรือไม่ และใช้ฐานข้อมูลแบบไหน ไม่ต้องรู้รายละเอียดลึก แค่บอกชื่อระบบ เวอร์ชัน และผู้ติดต่อได้ก็พอ เรื่องนี้มีผลกับงบมากที่สุด เพราะระบบเก่าที่ไม่มีช่องทางเชื่อมต้องทำงานเพิ่มอีกชั้น
API ที่ใช้เฉพาะแอปของบริษัทเองกับ API ที่เปิดให้พาร์ทเนอร์ภายนอกใช้ ต้องออกแบบต่างกันมาก แบบหลังต้องมีเอกสาร การออกกุญแจให้แต่ละราย และการจำกัดการใช้งาน บอกด้วยว่าคาดว่าจะมีผู้ใช้พร้อมกันประมาณเท่าไร ช่วงไหนคนใช้มากที่สุด เช่น ช่วงโปรโมชันหรือสิ้นเดือน ตัวเลขคร่าว ๆ ก็ช่วยให้ทีมเลือกโครงสร้างที่ไม่ใหญ่เกินจำเป็น
เตรียมตัวอย่างข้อมูลจริงสักชุด เช่น ใบสั่งซื้อ 3-5 ใบที่ลบข้อมูลส่วนตัวแล้ว รูปหน้าจอที่ใช้อยู่ และไฟล์ที่ส่งต่อกันประจำ ถ้าต้องเชื่อมกับบริการภายนอก เช่น LINE OA ระบบชำระเงิน หรือโปรแกรมบัญชี ให้รวบรวมลิงก์เอกสารสำหรับนักพัฒนาและบัญชีทดสอบไว้ด้วย ตัวอย่างข้อมูลจริงช่วยให้เจอปัญหาที่คาดไม่ถึงตั้งแต่ตอนประเมิน เช่น รหัสสินค้าที่ไม่ตรงกันระหว่างสองระบบ
กำหนดว่าใครควรเห็นข้อมูลส่วนไหน เช่น ลูกค้าเห็นเฉพาะออเดอร์ของตัวเอง พนักงานสาขาเห็นเฉพาะสาขาตัวเอง และข้อมูลไหนเป็นข้อมูลส่วนบุคคลตาม PDPA เตรียมบัญชีสำหรับทีมพัฒนาที่มีสิทธิ์เท่าที่จำเป็น แยกจากบัญชีผู้ดูแลหลัก และตกลงวิธีส่งรหัสผ่านหรือกุญแจที่ไม่ใช่การส่งในแชตกลุ่ม เรื่องนี้ควรคุยตั้งแต่แรก เพราะการเพิ่มระบบสิทธิ์ภายหลังมักต้องแก้ทั้งโครง
API ต้องมีคนดูแลเมื่อระบบปลายทางเปลี่ยน เช่น บริการภายนอกออกเวอร์ชันใหม่หรือเลิกใช้ช่องทางเดิม ตัดสินใจไว้ก่อนว่าทีมภายในจะรับช่วงต่อ หรือจ้างทีมพัฒนาดูแลรายเดือน ถ้าทีมภายในรับต่อ ให้ระบุในขอบเขตงานว่าต้องได้เอกสาร API ชุดทดสอบ และการสอนใช้งาน ถ้าจ้างดูแล ให้ตกลงเวลาตอบกลับเมื่อระบบมีปัญหาไว้เป็นลายลักษณ์อักษร
| เรื่อง | เตรียมอะไร | ถ้าไม่เตรียม |
|---|---|---|
| 1. เป้าหมาย | ประโยคธุรกิจ 1-2 ข้อ + ตัวเลขที่อยากเห็น | งานบานปลาย ทำส่วนที่ไม่ได้ใช้ |
| 2. ระบบและข้อมูล | รายชื่อระบบ เวอร์ชัน ผู้ดูแล | ใบเสนอราคาคลาดเคลื่อนมากที่สุด |
| 3. ผู้เรียกใช้ | แอป เว็บ หรือพาร์ทเนอร์ + จำนวนผู้ใช้คร่าว ๆ | ระบบใหญ่เกินหรือเล็กเกินความจริง |
| 4. ตัวอย่างข้อมูล | ข้อมูลจริงที่ลบข้อมูลส่วนตัวแล้ว + เอกสารระบบภายนอก | เจอปัญหาข้อมูลไม่ตรงกันตอนใกล้เสร็จ |
| 5. สิทธิ์และความปลอดภัย | ใครเห็นอะไร + บัญชีสำหรับทีมพัฒนา | ต้องรื้อโครงเมื่อเพิ่มสิทธิ์ภายหลัง |
| 6. คนดูแลต่อ | ทีมภายในหรือจ้างดูแล + เอกสารที่ต้องได้ | ระบบหยุดเมื่อบริการภายนอกเปลี่ยน |
ไม่ต้อง เรื่องที่ 1 และ 2 สำคัญที่สุด มีสองเรื่องนี้ก็เริ่มคุยได้ ส่วนเรื่องอื่นทีมพัฒนาที่ดีจะช่วยถามและเติมให้ครบในช่วงประเมินงาน
ติดต่อผู้ขายโปรแกรมหรือผู้ที่เคยทำระบบให้ แล้วถามสามข้อ คือ ระบบมีช่องทางเชื่อมหรือส่งออกข้อมูลหรือไม่ ต้องเสียค่าเปิดใช้เพิ่มหรือไม่ และมีเอกสารให้นักพัฒนาหรือไม่
ส่งเฉพาะตัวอย่างที่ลบหรือเปลี่ยนข้อมูลส่วนบุคคลแล้ว และทำสัญญาไม่เปิดเผยข้อมูลก่อนส่งของจริง ถ้าต้องให้เข้าระบบจริงให้สร้างบัญชีแยกที่ปิดได้ทันทีเมื่อจบงาน
เมื่อเตรียม 6 เรื่องนี้แล้ว ขั้นต่อไปคือเข้าใจว่าแต่ละเรื่องมีผลกับงบอย่างไร อ่านต่อได้ที่ค่าพัฒนา API ขึ้นกับอะไร: 6 ปัจจัยที่ทำให้งบต่างกัน ทีมงาน Smart Cyber Tech รับเชื่อมต่อระบบด้วย API ตั้งแต่ช่วยไล่เช็กลิสต์ ประเมินระบบเดิม จนถึงส่งมอบเอกสารและดูแลต่อ ส่งรายละเอียดที่มีอยู่มาได้ที่ แบบฟอร์มติดต่อ แม้ยังเตรียมไม่ครบก็เริ่มคุยได้
บทความอื่นที่เกี่ยวข้อง
ค่าพัฒนา API ขึ้นกับว่าระบบต้องรับส่งข้อมูลกี่เรื่อง ต้องเชื่อมกับระบบอื่นกี่ตัว ข้อมูลเดิมพร้อมแค่ไหน และต้องปลอดภัยและรับคนพร้อมกันได้เท่าไร งานที่ฟังดูเหมือนกันว่า "ทำ API ให้แอป" จึงต่างกันได้หลายเท่า บทความนี้อธิบาย 6 ปัจจัยที่ทีมพัฒนาใช้ประเมินงาน พร้อมรายการข้อมูลที่ควรเตรียมก่อนขอใบเสนอราคา เพื่อให้ราคาจากหลายทีมเทียบกันได้จริง
อ่านบทความ
API (Application Programming Interface) คือช่องทางที่โปรแกรมหนึ่งใช้ขอข้อมูลหรือสั่งงานอีกโปรแกรมตามรูปแบบที่ตกลงกันไว้ ทำให้ระบบต่าง ๆ ของธุรกิจคุยกันเองได้โดยไม่ต้องมีคนคัดลอกข้อมูลไปมา ธุรกิจเริ่มต้องมี API เมื่อข้อมูลชุดเดียวกันถูกใช้ในหลายที่ เช่น มีทั้งเว็บและแอป ต้องส่งข้อมูลให้พาร์ตเนอร์ หรือพนักงานต้องคีย์ข้อมูลซ้ำหลายระบบทุกวัน บทความนี้อธิบายแบบไม่ใช้ศัพท์เทคนิค พร้อม 6 สัญญาณที่บอกว่าถึงเวลาลงทุนแล้ว
อ่านบทความ
ธุรกิจไทยจำนวนมากรับออเดอร์จากหลายช่องทาง แจ้งลูกค้าผ่าน LINE และออกเอกสารด้วยโปรแกรมบัญชีออนไลน์ แต่ทั้งสามส่วนยังเชื่อมกันด้วยการคัดลอกข้อมูลด้วยมือ การเชื่อมผ่าน API ทำให้ออเดอร์หนึ่งรายการเดินจากหน้าร้านไปถึงข้อความแจ้งลูกค้าและใบกำกับภาษีได้เอง บทความนี้อธิบายว่าข้อมูลไหลอย่างไร LINE OA และโปรแกรมบัญชีทำอะไรได้บ้างเมื่อเชื่อมแล้ว และจุดที่ทำให้งานเชื่อมระบบพังบ่อยที่สุด
อ่านบทความตั้งแต่ประเมินระบบปัจจุบัน วางแผน จนถึงลงมือพัฒนา — คุยกับเราได้โดยไม่มีค่าใช้จ่าย
