การทำความเข้าใจ API และพร็อกซี API

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

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

วิดีโอ: ดูวิดีโอสั้นๆ นี้สำหรับข้อมูลเบื้องต้นเกี่ยวกับพร็อกซี API

API คืออะไร

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

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

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

Edge ยังช่วยให้คุณสร้าง API ได้โดยใช้แอปพลิเคชันที่โฮสต์ในแพลตฟอร์มบริการ API โดยไม่ต้องมีบริการแบ็กเอนด์มาเกี่ยวข้อง คุณสร้างแอปพลิเคชันเหล่านี้ใน JavaScript, Java และใน Node.js ได้

พร็อกซี API คืออะไร

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

ในการกำหนดค่าพร็อกซี API ปลายทางจะมี 2 ประเภทดังนี้

  • ProxyEndpoint: กำหนดวิธีที่แอปไคลเอ็นต์ใช้ API ของคุณ คุณกำหนดค่า ProxyEndpoint เพื่อกำหนด URL ของพร็อกซี API ปลายทางของพร็อกซียังกำหนดว่าแอปเข้าถึงพร็อกซี API ผ่าน HTTP หรือ HTTPS อีกด้วย โดยปกติแล้วคุณแนบนโยบายกับ ProxyEndpoint เพื่อบังคับใช้การรักษาความปลอดภัย การตรวจสอบโควต้า การควบคุมการเข้าถึงและการจำกัดอัตราประเภทอื่นๆ
  • TargetEndpoint: กำหนดวิธีที่พร็อกซี API โต้ตอบกับบริการแบ็กเอนด์ คุณกำหนดค่า TargetEndpoint ให้ส่งต่อคำขอไปยังบริการแบ็กเอนด์ที่เหมาะสม ซึ่งรวมถึงการกำหนดการตั้งค่าความปลอดภัย โปรโตคอล HTTP หรือ HTTPS และข้อมูลการเชื่อมต่ออื่นๆ คุณแนบนโยบายกับ TargetEndpoint ได้เพื่อให้แน่ใจว่าข้อความตอบกลับจะได้รับการจัดรูปแบบอย่างถูกต้องสำหรับแอปที่ส่งคำขอเริ่มต้น

คุณแสดงภาพพร็อกซี API ได้ตามภาพกราฟิกด้านล่าง

คำขอ HTTP ที่ป้อนผ่านปลายทางคำขอพร็อกซีจะส่งไปยังปลายทางคำขอเป้าหมาย แล้วส่งไปยังบริการแบ็กเอนด์ การตอบสนองของ HTTP ที่ป้อนผ่านปลายทางการตอบสนองเป้าหมายจะส่งไปยังปลายทางการตอบสนองของพร็อกซี แล้วกลับไปยังไคลเอ็นต์

คุณจะสร้างพร็อกซี API ได้อย่างไร

พร็อกซี API ประกอบด้วยโค้ดและไฟล์การกำหนดค่า XML (เช่น JavaScript และ Java) Apigee เป็นวิธีที่ให้คุณสร้างพร็อกซี API ได้หลายวิธี เช่น

  • การใช้ UI การจัดการ Edge เพื่อกำหนดพร็อกซี API ในอินเทอร์เฟซผู้ใช้แบบกราฟิก (GUI) ดูข้อมูลเพิ่มเติมได้ที่สร้างพร็อกซี API แบบง่าย
  • การสร้างไฟล์ XML พร้อมกับไฟล์สนับสนุนอื่นๆ ที่กำหนดพร็อกซี API ของคุณ แล้วนำเข้าไฟล์ไปยัง Edge
  • การใช้ Edge Management API เพื่อสร้างพร็อกซี API โดยสร้างชุดคำขอ REST ไปยัง Edge
  • ทำให้แอปพลิเคชัน Node.js ใช้งานได้เป็นพร็อกซี โปรดดูการทำให้แอป Node.js แบบสแตนด์อโลนใช้งานได้

นโยบายคืออะไร

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

สร้างพร็อกซี API แรก

Apigee มีชุดบทแนะนำที่คุณสามารถใช้สร้าง API แรกได้ เริ่มต้นด้วยสร้างพร็อกซี API แรกของคุณ

วิธีการที่ดีในการเรียนรู้เกี่ยวกับพร็อกซี API คือการทำงานกับตัวอย่างตามที่อธิบายไว้ในการใช้พร็อกซี API ตัวอย่าง

ดูข้อมูลเพิ่มเติม