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

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

Apigee Edge ช่วยให้คุณสร้าง RESTful API ที่นักพัฒนาแอป ใช้ได้ง่ายและรวดเร็ว คุณจะเปิดเผย API ใน Edge โดยการสร้างพร็อกซี API ที่ทำหน้าที่เป็น "ส่วนหน้า" ที่มีการจัดการสำหรับ บริการแบ็กเอนด์ หัวข้อนี้จะอธิบายความสัมพันธ์ระหว่าง 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 Services โดยไม่ต้องใช้บริการแบ็กเอนด์ คุณสามารถสร้างแอปพลิเคชันเหล่านี้ใน 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 ตัวอย่าง

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