ประเด็นสําคัญของการพัฒนาพร็อกซี 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 Proxy ได้ที่การต่อ API Proxy เข้าด้วยกัน

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

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

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

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

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

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