ประเด็นสําคัญของการพัฒนาพร็อกซี API

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

หัวข้อนี้แสดงลักษณะพื้นฐานบางอย่างของพร็อกซี API พร้อมลิงก์ไปยังข้อมูลเพิ่มเติม

API เป็นจุดเริ่มต้นให้แอปพลิเคชันหนึ่งใช้ความสามารถของอีกแอปพลิเคชันหนึ่ง คุณติดตั้งใช้งานพร็อกซี API เพื่อสร้าง API

ใน Apigee Edge คุณติดตั้งใช้งานพร็อกซี API โดยกำหนดค่าตรรกะของพร็อกซี API เป็นลำดับของ ขั้นตอนที่จะดำเนินการเพื่อตอบสนองต่อคำขอจากโค้ดไคลเอ็นต์ คุณเปิดเผยพร็อกซี API ให้ไคลเอ็นต์ โดยกำหนดจุดปลายทางที่มี URL พร้อมเส้นทางทรัพยากร, คำกริยา HTTP, ข้อกำหนดของเนื้อหา และอื่นๆ

แม้ว่าจะเรียกว่าพร็อกซี API แต่จากมุมมองของโค้ดไคลเอ็นต์ พร็อกซี API ก็คือ API

ดูภาพรวมของพร็อกซี API ได้ที่ ทำความเข้าใจ API และพร็อกซี API

คุณจัดลำดับตรรกะของพร็อกซี API โดยใช้โฟลว์

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโฟลว์ได้ที่ การควบคุม วิธีที่พร็อกซีดำเนินการด้วยโฟลว์

คุณเข้าถึงข้อมูลสถานะผ่าน ตัวแปรโฟลว์ที่สร้างโดยพร็อกซี API

พร็อกซี API มีสิทธิ์เข้าถึงตัวแปรที่แสดงถึงสถานะการดำเนินการ คุณสามารถเข้าถึงตัวแปรเหล่านี้ได้จาก XML ที่กำหนดค่าพร็อกซี API และนโยบาย นอกจากนี้ คุณยังเข้าถึงตัวแปรเหล่านี้ได้เมื่อขยายพร็อกซี API ด้วยภาษาเชิงกระบวนการ เช่น Java, JavaScript หรือ Python

ตัวแปรเหล่านี้จะจัดเก็บไว้ใน Apigee Edge ตัวแปรบางรายการมีอยู่โดยค่าเริ่มต้น ซึ่งมักจะเป็นเพราะตัวแปรเหล่านั้นเป็นเรื่องปกติ ที่พร็อกซี API ทำ (เช่น เป็นส่วนหนึ่งของคำขอ HTTP) นอกจากนี้ คุณยังสร้าง ตัวแปรของคุณเองเพื่อให้เป็นไปตามข้อกำหนดด้านตรรกะได้ด้วย

ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรได้ที่ การจัดการสถานะพร็อกซีด้วยตัวแปร โฟลว์

คุณสามารถกำหนดให้พร็อกซี API ดำเนินการแบบมีเงื่อนไขได้

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการดำเนินการแบบมีเงื่อนไขได้ที่ ตัวแปรโฟลว์และ เงื่อนไข

คุณติดตั้งใช้งานตรรกะส่วนใหญ่ในพร็อกซี API โดยใช้นโยบาย

ตรรกะส่วนใหญ่ที่คุณเพิ่มลงในพร็อกซี API จะรวมอยู่ในนโยบาย นโยบายเป็นคอมโพเนนต์ของ Apigee Edge ที่ห่อหุ้มตรรกะสำหรับพื้นที่การทำงาน เช่น การรักษาความปลอดภัยหรือการจัดการการรับส่งข้อมูล คุณกำหนดค่านโยบายด้วย XML ที่ตั้งค่าพร็อพเพอร์ตี้สำหรับตรรกะพื้นฐาน คุณจัด นโยบายเป็นลำดับ "ขั้นตอน" ภายในโฟลว์ เพื่อให้พร็อกซี API ดำเนินการตรรกะตามลำดับที่ดีที่สุดเพื่อให้บรรลุเป้าหมายของพร็อกซี

ดูข้อมูลเพิ่มเติมเกี่ยวกับนโยบายได้ที่นโยบายคืออะไร

คุณสามารถรวมชุดฟังก์ชันการทำงานที่นำกลับมาใช้ซ้ำได้

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโฟลว์ที่แชร์ได้ที่ โฟลว์ที่แชร์ที่นำกลับมาใช้ซ้ำได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงพร็อกซี API ได้ที่ การเชื่อมโยงพร็อกซี API เข้าด้วยกัน

คุณสามารถแก้ไขข้อบกพร่องของพร็อกซีด้วยเครื่องมือติดตาม

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขข้อบกพร่องด้วยเครื่องมือติดตามได้ที่การใช้เครื่องมือติดตาม

คุณจัดการข้อผิดพลาดของพร็อกซี API เป็นข้อผิดพลาด

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

ดูข้อมูลเพิ่มเติมได้ที่ การจัดการ ข้อผิดพลาด