รายการตัวอย่าง

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

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

ดูวิธีการใช้ตัวอย่างได้ที่การใช้พร็อกซี API ตัวอย่าง

เรียนรู้จากการลงมือทำ

หากต้องการลงมือปฏิบัติอย่างรวดเร็วและเริ่มสร้างฐานความรู้ที่มั่นคงเกี่ยวกับ Apigee Edge เรามีไลบรารีตัวอย่าง "learn-edge" ใน GitHub ที่ช่วยให้คุณสามารถติดตั้งใช้งาน เรียกใช้ และติดตามพร็อกซีตัวอย่างบางรายการได้อย่างรวดเร็ว โดยเริ่มจากพร็อกซีที่ง่ายที่สุดและไปยังพร็อกซี ที่แสดงการตรวจสอบคีย์ API, โควต้า, การแคชการตอบกลับ, การจัดการข้อผิดพลาด และอื่นๆ

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

ลองใช้เลย https://github.com/apigee/api-platform-samples/tree/master/learn-edge

ตัวอย่างสูตรอาหารในเอกสาร

เรามีชุดตัวอย่างสำหรับหัวข้อในตำราพร็อกซี API

ชื่อ คำอธิบาย ประเภทของนโยบาย แหล่งข้อมูล
javascript-cookbook แสดงตัวอย่าง JavaScript อย่างง่ายที่เพิ่มส่วนหัว HTTP จากตัวแปร แปลงรายงานสภาพอากาศในรูปแบบ XML จาก JSON เป็น XML และตัดเนื้อหาให้สั้นลงสำหรับ ไคลเอ็นต์บนอุปกรณ์เคลื่อนที่

Javascript
XMLToJSON

minimize.js
setHeaders.js
javascript-mashup-cookbook แอปพลิเคชัน JavaScript ที่สมบูรณ์ซึ่งเรียกใช้ API สาธารณะ รวมผลลัพธ์ และ สร้างการตอบกลับที่สมบูรณ์สำหรับแอปไคลเอ็นต์ (หมายเหตุ: พร็อกซี API นี้ใช้ฟังก์ชันการทำงานเดียวกับ การผสมนโยบาย ซึ่งแสดงให้เห็นว่าปัญหาเดียวกันสามารถแก้ไขได้โดยใช้เทคนิคที่แตกต่างกัน) JavaScript MashItUp.js
java-hello การเรียกใช้ Java แบบง่ายๆ ที่แสดงข้อความ "Hello World" JavaCallout JavaHello.java
java-cookbook แปลงเนื้อหาและการตอบกลับเป็นตัวพิมพ์ใหญ่ JavaCallout
ResponseUppercase.java
java-properties แสดงวิธีใช้พร็อพเพอร์ตี้ใน Callout ของ Java JavaCallout JavaProperties.java
java-error แสดงรูปแบบการจัดการข้อผิดพลาดที่คุณใช้ในโค้ด Java Callout ได้ JavaCallout JavaError.java
policy-mashup-cookbook แอปพลิเคชันที่สมบูรณ์ซึ่งใช้การเรียงนโยบายเพื่อเรียก API สาธารณะ 2 รายการ รวมผลลัพธ์ และสร้างการตอบกลับที่สมบูรณ์สำหรับแอปไคลเอ็นต์ (หมายเหตุ: พร็อกซี API นี้ ใช้ฟังก์ชันการทำงานเดียวกันกับ JavaScript Mashup ซึ่งแสดงให้เห็นว่าปัญหาเดียวกัน สามารถแก้ไขได้โดยใช้เทคนิคที่แตกต่างกัน) AssignMessage
ServiceCallout
ExtractVariables
Javascript
XMLToJSON
GenerateResponse.js

พร็อกซี API ตัวอย่าง

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

ข้อมูลอ้างอิงและเครื่องมือ

นอกจากตัวอย่างในเอกสารสูตรอาหารและพร็อกซีตัวอย่างในตารางด้านบนแล้ว ตัวอย่าง GitHub ของ Edge ยังมีแหล่งข้อมูลต่อไปนี้ด้วย

ชื่อ คำอธิบาย ประเภทของนโยบาย แหล่งข้อมูล
regex-protection นโยบายการป้องกันภัยคุกคามของนิพจน์ทั่วไปช่วยปกป้อง API ของแบ็กเอนด์และ ไมโครเซอร์วิสจากการโจมตีด้วย SQL Injection ได้

การป้องกัน นิพจน์ทั่วไป

ไม่มี
oauth-validate-key-secret คุณกำลังติดตั้งใช้งานขั้นตอนประเภทการให้สิทธิ์รหัสผ่าน OAuth คุณต้องตรวจสอบทั้งคีย์ไคลเอ็นต์ของแอปพลิเคชันและข้อมูลลับใน Edge ก่อนที่จะเรียกผู้ให้บริการข้อมูลประจำตัวภายนอกเพื่อตรวจสอบข้อมูลเข้าสู่ระบบของผู้ใช้ OAuthV2, อื่นๆ ไม่มี
condition-pattern-matching พร็อกซีนี้ช่วยให้คุณลองและทดสอบคำสั่งแบบมีเงื่อนไขในโฟลว์พร็อกซี API ได้อย่างง่ายดาย AssignMessage ไม่มี
access-entity แสดงวิธีดึงข้อมูลโปรไฟล์สำหรับเอนทิตีจากที่เก็บข้อมูล Apigee Edge AssignMessage
AccessEntity
ExtractVariables
ไม่มี
apikey ใช้การตรวจสอบคีย์ API อย่างง่าย VerifyAPIKey
AssignMessage
Quota
ไม่มี
async-callout แสดงการเรียกออกแบบอะซิงโครนัสอย่างง่ายโดยใช้ httpClient ของ JavaScript JavaScript assemble_response.js
callout.js
base64encoder แสดงวิธีเรียกใช้ JavaScript ที่รวมจากทรัพยากร JavaScript ในพร็อกซี API AssignMessage
Javascript
core-min.js
enc-utf16-min.js
enc-base64-min.js
encodeAuthHeader.js
conditional-policy ใช้การบังคับใช้นโยบายแบบมีเงื่อนไขอย่างง่าย เมื่อคำขอมีส่วนหัว HTTP responsetime:true นโยบายจะเรียกใช้สคริปต์ Python ที่เพิ่มชุดเมตริกประสิทธิภาพ ลงในข้อความตอบกลับเป็นส่วนหัว HTTP สคริปต์ (Python) timer.py
dynamic-endpoint ใช้การกำหนดเส้นทางแบบมีเงื่อนไขอย่างง่ายในสถานการณ์ที่ซับซ้อนขึ้นเล็กน้อย ซึ่งกำหนด URL 2 รายการและเส้นทางเริ่มต้น 1 รายการ ไม่มี ไม่มี
jira-release-notes นี่คือพร็อกซี API ที่ทีมเอกสารของ Apigee ใช้เพื่อสร้างหมายเหตุประจำรุ่นจาก Jira JSONToXML
XSL
releasenotes_api.xsl
kerberos-credential-mediation ตัวอย่างนี้แสดงวิธีดำเนินการไกล่เกลี่ยข้อมูลเข้าสู่ระบบ Kerberos ใน Apigee Edge JavaCallout ไฟล์ JAR ของ Java
oauth-advanced ตัวอย่างที่ใช้งานได้จริงของขั้นตอนประเภทการให้สิทธิ์รหัสการให้สิทธิ์ โดยมี Apigee Edge เป็นเซิร์ฟเวอร์การให้สิทธิ์

GenerateAccessToken
GenerateAuthCode
RefreshAccessToken

และอีกมากมาย...

ดูโค้ดตัวอย่าง
oauth-client-credentials แสดงปลายทางของโทเค็น OAuth 2.0 ที่ทำงานได้อย่างเต็มรูปแบบซึ่งกำหนดค่าสำหรับประเภทการให้สิทธิ์ข้อมูลเข้าสู่ระบบของไคลเอ็นต์ GenerateAccessToken ไม่มี
oauth-login-app เลิกใช้งานแล้ว เราขอแนะนำให้คุณดูตัวอย่าง oauth-advanced แทน
oauth-validate-key-secret แสดงเทคนิคในการตรวจสอบคีย์และข้อมูลลับของไคลเอ็นต์ก่อนเรียกผู้ให้บริการข้อมูลประจำตัวเพื่อตรวจสอบข้อมูลเข้าสู่ระบบของผู้ใช้ในโฟลว์ประเภทการให้สิทธิ์รหัสผ่าน OAuthV2
AssignMessage
ExtractVariables
ServiceCallout
RaiseFault
ไม่มี
oauth-verify-accesstoken แสดงพร็อกซี API ที่กำหนดค่าเพื่อตรวจสอบโทเค็นเพื่อการเข้าถึง OAuth 2.0 และ ยืนยันโควต้า VerifyAccessToken
Quota
ไม่มี
oauth10a-3legged แสดงการกำหนดค่า OAuth 1.0a แบบ 3 ทาง GenerateAccessToken
GenerateRequestToken
ServiceCallout
VerifyAccessToken
ไม่มี
outbound-oauth ใช้ Microsoft Azure Translator API เพื่อแปลทวีต โดยจะทำการเรียกขาออกเพื่อรับโทเค็นเพื่อการเข้าถึง OAuth จากนั้นจะแคชโทเค็นโดยใช้นโยบายการแคชของบริการ API และนำโทเค็นที่แคชไว้กลับมาใช้ใหม่ทุกครั้งที่มีการเรียกขาออก นอกจากนี้ยังมีแอปเบราว์เซอร์สาธิตที่ใช้เรียกใช้พร็อกซี API AssignMessage
LookupCache
PopulateCache
Javascript
api-config.js
api-token-get.js
translate-query.js
translate-results.js
การแบ่งหน้า แบ่งหน้าข้อความตอบกลับ XML ตามพารามิเตอร์ limit และ offset ที่ไคลเอ็นต์ระบุ ไว้ AssignMessage
ExtractVariables
ResponseCache
VerifyApiKey
XSL
paginate.xslt
response-cache แสดงวิธีแคชพยากรณ์อากาศใน Edge เป็นเวลา 10 นาที ResponseCache
AssignMessage
ไม่มี
simple-python แสดงสถานการณ์ง่ายๆ ในการแนบสคริปต์ Python ใน
การตอบกลับซึ่งจะเพิ่มค่าส่วนหัวลงในการตอบกลับ
สคริปต์ (Python) setHeader.py
soap แสดงการแปลง XSL ที่เขียนไฟล์ WSDL ใหม่เพื่อตอบสนองต่อคำขอ ที่มีพารามิเตอร์การค้นหา ?wsdl AssignMessage
ExtractVariables
Script (Python)
XSL
calculateaddress.py
fixwsdl.xsl
การสตรีม แสดงการกำหนดค่าการสตรีม HTTP ไม่มี ไม่มี
target-reroute แสดงการใช้ JavaScript เพื่อเลือก URL เป้าหมายแบบไดนามิกตามเนื้อหา ของข้อความคำขอ ExtractVariables
Javascript
rewriteTargetUrl.js
twitter-mobile-timeline แสดงวิธีใช้ JavaScript เพื่อนำพารามิเตอร์ที่ไม่จำเป็นออกจากทวีต ซึ่งจะส่งผลให้ไทม์ไลน์ Twitter มีประสิทธิภาพมากขึ้นและเหมาะสำหรับอุปกรณ์เคลื่อนที่ที่มีข้อจำกัดด้านทรัพยากร AssignMessage
Javascript
MobileTimeline.js
twitter-oembed แปลงการตอบกลับไทม์ไลน์ (เช่น จาก statuses/user_timeline.json) เป็นการตอบกลับ oEmbed ที่มีข้อมูลไทม์ไลน์เป็นเนื้อหา HTML ที่สมบูรณ์ AssignMessage
JavaScript
search-oembed.js
ตัวแปร แสดงวิธีแยกและตั้งค่าตัวแปรตามเนื้อหาข้อความใน Transport, JSON และ XML AssignMessage
ExtractVariables
XMLToJSON
minimize.js
xmltojson แปลงข้อมูลการตอบกลับจาก XML เป็น JSON XMLToJSON
JSONToXML
ไม่มี

/schemas

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

/tools

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

/org-snapshot

เครื่องมือสแนปชอตขององค์กรจะดึงการตั้งค่าขององค์กร ซึ่งรวมถึงนักพัฒนาซอฟต์แวร์ ผลิตภัณฑ์ API, โฮสต์เสมือน, แมปคีย์/ค่า ฯลฯ โดยสามารถใช้เพื่อสำรองข้อมูลรายละเอียดของ องค์กร หรือเพื่อค้นหาการตั้งค่าในองค์กร

Apigee-127

หากคุณเป็นโปรแกรมเมอร์ Apigee-127 จะช่วยให้คุณเริ่มเขียนโค้ด พร็อกซี API ด้วย Node.js และ Swagger ได้ นอกจากนี้ คุณยังดูตัวอย่าง a127 ได้ใน GitHub ที่ https://github.com/apigee-127/a127-samples

แชร์ประสบการณ์ของคุณ

แชร์ประสบการณ์ของคุณในฟอรัมนักพัฒนาซอฟต์แวร์ Apigee