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

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

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

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

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 Proxies พร็อกซี API จะแยก API ที่แสดงต่อแอปออกจากบริการแบ็กเอนด์ ซึ่งจะช่วยปกป้องแอปเหล่านั้นจากการเปลี่ยนแปลงโค้ดแบ็กเอนด์ เมื่อคุณทําการเปลี่ยนแปลงแบ็กเอนด์ในบริการ แอปจะเรียก API เดียวกันต่อไปโดยไม่หยุดชะงัก

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

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

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

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

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

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

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

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

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

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

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

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

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