วิธีสร้างปลายทางและทำไมคุณถึงต้องการมัน

จุดปลายเป็นส่วนสำคัญของกระบวนการทางธุรกิจและการพัฒนาแอปพลิเคชันโดยทั่วไป ในบทความนี้ เรากำหนดว่าปลายทางคืออะไร เหตุใดเราจึงต้องการ และวิธีสร้างบนแพลตฟอร์ม AppMaster.io

จุดสิ้นสุดคืออะไร?

ปลายทางคือเกตเวย์ที่เชื่อมต่อกระบวนการเซิร์ฟเวอร์ของแอปพลิเคชันกับอินเทอร์เฟซภายนอก กล่าวคือ นี่คือที่อยู่สำหรับส่งคำขอ

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

หากต้องการเชื่อมต่อกับ API คุณต้องส่งคำขอ สำหรับการประมวลผลคำขอที่ถูกต้อง ไคลเอ็นต์ต้องจัดเตรียมตัวชี้ทรัพยากรสากล (URL) เมธอด HTTP และเพิ่มส่วนหัว เนื้อหา และพารามิเตอร์คำขอ ทั้งนี้ขึ้นอยู่กับวิธีการ ส่วนหัวให้ข้อมูลเมตาเกี่ยวกับคำขอ ในขณะที่เนื้อหามีข้อมูล เช่น ฟิลด์สำหรับแถวใหม่ในฐานข้อมูล

API จะประมวลผลคำขอและส่งการตอบกลับที่ได้รับจากเซิร์ฟเวอร์ การตอบกลับจะมีรหัสสถานะ ซึ่งเป็นส่วนหนึ่งของข้อความตอบกลับ HTTP ที่แจ้งให้ลูกค้าทราบถึงผลลัพธ์ของคำขอ ตัวอย่างเช่น ใช้รหัส 200 หากการดำเนินการเสร็จสมบูรณ์ 500 หากเกิดข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

ปลายทางทำงานร่วมกับเมธอด API เหล่านี้เป็น URL เฉพาะที่แอปพลิเคชันใช้เพื่อสื่อสารกับบริการของบุคคลที่สามและผู้ใช้ URL คือเส้นทางที่สามารถจัดการวิธีการขอต่างๆ ได้ คำขอแต่ละประเภทเป็นจุดปลายทางที่แยกจากกัน มีห้าประเภทหลัก:

• GET — รับข้อมูลจากเซิร์ฟเวอร์ ไม่ต้องการเนื้อหาที่ร้องขอ
• POST — สร้างอ็อบเจ็กต์ใหม่ในฐานข้อมูล ต้องการเนื้อหาคำขอพร้อมฟิลด์ของอ็อบเจ็กต์นี้
• PUT — รีเซ็ตวัตถุเฉพาะในฐานข้อมูลอย่างสมบูรณ์
• PATCH — คล้ายกับ PUT รีเซ็ตออบเจกต์เฉพาะในฐานข้อมูล แต่จะอัปเดตเฉพาะฟิลด์ที่กล่าวถึงในเนื้อหาคำขอเท่านั้น
• DELETE — ลบวัตถุออกจากฐานข้อมูล

เมื่อสร้างคำขอเฉพาะ สามารถเพิ่มพารามิเตอร์ต่างๆ ได้ การรวมกันของพารามิเตอร์เหล่านี้และ URL แสดงถึง URI — Uniform Resource Identifier ระบุตำแหน่งและวิธีค้นหาทรัพยากร

คุณจะกำหนดค่าปลายทางบนแพลตฟอร์ม AppMaster.io ได้อย่างไร

ในส่วน Endpoints ของแพลตฟอร์ม AppMaster.io คุณสามารถดูปลายทางที่สร้างขึ้นโดยอัตโนมัติและปลายทางของโปรเจ็กต์ของคุณได้ หากเปิดใช้งานการสร้างหน้าจอและหน้าอัตโนมัติในโปรเจ็กต์ของคุณ จะมีการสร้างปลายทางที่สอดคล้องกันสำหรับโมเดลข้อมูลที่สร้างขึ้นโดยอัตโนมัติ นอกจากนี้ยังสามารถสร้างปลายทางได้โดยอัตโนมัติเมื่อติดตั้งโมดูลบางโมดูล เช่น การอนุญาต (Auth) ประเทศและเมือง และอื่นๆ

AppMaster.io ช่วยให้คุณทำงานกับ API ปลายทางได้หลายประเภท:

• API สำหรับการเข้าถึงแบ็กเอนด์จากไคลเอนต์และระบบของบุคคลที่สาม
• เว็บฮุคสำหรับรับการแจ้งเตือนจากระบบของบุคคลที่สาม
• WebSockets สำหรับการเปิดเซสชันการสื่อสารแบบโต้ตอบสองทางระหว่างเบราว์เซอร์และเซิร์ฟเวอร์โดยไม่ต้องขอการตอบสนองจากเซิร์ฟเวอร์

ปลายทางทั้งหมดถูกจัดกลุ่ม ภายในแต่ละกลุ่ม คุณจะพบปลายทางที่เกี่ยวข้องทั้งหมด ประเภทคำขอ URL และกระบวนการทางธุรกิจที่เชื่อมต่อ คุณสามารถลบและแก้ไขปลายทางทั้งหมดได้

เมื่อสร้างหรือแก้ไขปลายทาง จะมีตัวเลือกต่อไปนี้ในหน้าต่างการกำหนดค่า:

1. วิธีการขอ GET, POST, PUT, DELETE หรือ PATCH
2. ขอ URL ไม่ได้ระบุส่วนแรกที่มีพาธไปยังเซิร์ฟเวอร์ เนื่องจากส่วนปลายของแอปพลิเคชันทั้งหมดจะเหมือนกัน ตั้งค่าสิ้นสุดเช่น /users ก็เพียงพอแล้ว พารามิเตอร์ URL ยังระบุไว้ที่นี่ สมมติว่าปลายทางได้รับการออกแบบมาเพื่อรับข้อมูลเกี่ยวกับผู้ใช้เฉพาะ ในกรณีนั้น ID จะต้องเขียนหลัง ":" (/users/:id) และส่งผ่านเป็นพารามิเตอร์
3. กลุ่มปลายทาง พารามิเตอร์นี้มีจุดมุ่งหมายเพื่อจัดระเบียบและจัดโครงสร้างงานด้วยจุดปลาย ปลายทางทั้งหมดสามารถแบ่งออกเป็นกลุ่ม (โฟลเดอร์)
4. กระบวนการทางธุรกิจ. หนึ่งในพารามิเตอร์ที่สำคัญที่สุดที่กำหนดว่าปลายทางจะทำอะไร ในเวลาเดียวกัน ปลายทางเองยังคงไม่เปลี่ยนแปลง จะได้รับคำขอเดียวกันทั้งหมดจากที่อยู่เดิม และหากกระบวนการทางธุรกิจถูกแทนที่ ก็จะทำหน้าที่อื่น กระบวนการทางธุรกิจสำหรับการดำเนินการฐานข้อมูลพื้นฐานจะถูกสร้างขึ้นโดยอัตโนมัติ คุณไม่สามารถแก้ไขได้ แต่ถ้าจำเป็น คุณสามารถแทนที่ด้วย BP ที่กำหนดเองได้

นอกจากนี้ คุณสามารถตั้งค่ามิดเดิลแวร์ได้ มิดเดิลแวร์เป็นซอฟต์แวร์ตัวกลางที่ทำหน้าที่เป็นตัวกรองเมื่อประมวลผลคำขอของแอปพลิเคชัน มิดเดิลแวร์ใช้ตรวจสอบเงื่อนไขใดๆ ก่อนดำเนินการตามคำขอ ตัวอย่างเช่น หากคุณสร้างมิดเดิลแวร์เพื่อตรวจสอบการพิสูจน์ตัวตนผู้ใช้ มิดเดิลแวร์จะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าเข้าสู่ระบบหากผู้ใช้ไม่ได้เข้าสู่ระบบ หากเขาเข้าสู่ระบบ มิดเดิลแวร์จะไม่รบกวนการประมวลผลคำขอ ส่งต่อไปยัง ลูกค้า.

การสร้างปลายทางใน AppMaster.io

ลองพิจารณาการกำหนดค่าปลายทางในทางปฏิบัติและวิเคราะห์ผ่านตัวอย่างของโครงการ Aviato คุณสามารถค้นหาขั้นตอนทั้งหมดในการสร้างโปรเจ็กต์นี้ได้ใน หลักสูตร AppMaster.io

ภายในโครงการ เราได้สร้างกระบวนการทางธุรกิจสองขั้นตอน:

• ตรวจสอบและสร้างเที่ยวบิน — กระบวนการที่จะใช้เพื่อแทนที่กระบวนการทางธุรกิจสร้างเที่ยวบิน
• ลงทะเบียนผู้โดยสาร — สำหรับการลงทะเบียนผู้โดยสารสำหรับเที่ยวบินเฉพาะ

ตอนนี้เราสามารถใช้กระบวนการเหล่านี้เพื่อตั้งค่าปลายทางในโปรเจ็กต์ได้

เริ่มต้นด้วยการตรวจสอบความถูกต้องและสร้างกระบวนการทางธุรกิจเที่ยวบิน กลุ่มเที่ยวบินมีจุดสิ้นสุด POST/เที่ยวบินสำหรับการสร้างเที่ยวบินอยู่แล้ว ตอนนี้เราต้องเปลี่ยนกระบวนการทางธุรกิจที่แนบมาด้วยใหม่ ในการดำเนินการนี้ เราต้องแก้ไขปลายทาง

ในหน้าต่างการกำหนดค่า เลือกกระบวนการทางธุรกิจที่ต้องการ ในกรณีของเรา นี่คือการตรวจสอบและสร้างเที่ยวบิน BP หลังจากนั้น เราต้องเลือกตัวแปรอินพุตทั้งหมดที่จำเป็นและบันทึกการเปลี่ยนแปลง

ตอนนี้ เราสามารถตั้งค่าปลายทางถัดไปสำหรับกระบวนการธุรกิจลงทะเบียนผู้โดยสารได้

เป้าหมายของเราคือการสร้างส่วนเพื่อดูเที่ยวบินเฉพาะและผู้โดยสารที่เกี่ยวข้องและตั้งค่ากระบวนการลงทะเบียนผู้โดยสารใหม่

ในกลุ่มจุดสิ้นสุดของเที่ยวบิน เราต้องสร้างปลายทางใหม่: /flights/:id/register โดยที่ id อ้างถึงเที่ยวบินเฉพาะที่เราสามารถใช้เป็นข้อมูลเข้าในกระบวนการทางธุรกิจ

เมื่อคลิกที่ไอคอนเครื่องหมายบวก เราสามารถเพิ่มปลายทางใหม่ได้ วิธีการขอจะเป็น POST เนื่องจากเรากำลังสร้างวัตถุใหม่ เราเลือกกระบวนการลงทะเบียนผู้โดยสารสำหรับ BP ของเราและบันทึกการเปลี่ยนแปลงทั้งหมดที่ทำขึ้น

นั่นคือความง่ายในการสร้างปลายทางบนแพลตฟอร์ม AppMaster.io วิดีโอสอนแบบเต็ม:

บทสรุป

ปลายทางมีบทบาทสำคัญในการทำงานของ API ซึ่งจำเป็นสำหรับการขยายโครงการและการรวมบริการและแอปพลิเคชันที่สะดวก AppMaster.io แพลตฟอร์มที่ไม่มีโค้ดช่วยให้ทำงานกับปลายทางที่สร้างและกำหนดค่าได้ง่าย คุณสามารถลงทะเบียนบนแพลตฟอร์มและตรวจสอบการทำงานทั้งหมดได้ตลอดเวลา