Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
Apigee X. thông tin
Các mẫu API Apigee Edge chứa các proxy API, chính sách, mã và công cụ mẫu minh hoạ cho các chức năng của Dịch vụ API Apigee Edge như mô tả bên dưới.
Để biết hướng dẫn về cách sử dụng mẫu, hãy xem phần Sử dụng proxy API mẫu.
Học hỏi bằng thực hành
Bạn muốn nhanh chóng xây dựng nền tảng kiến thức vững chắc về Apigee Edge? Chúng tôi có thư viện mẫu "learn-edge" trên GitHub, cho phép bạn nhanh chóng triển khai, gọi và theo dõi một số proxy mẫu, bắt đầu bằng proxy đơn giản nhất và chuyển sang những proxy minh hoạ phương thức xác thực khoá API, hạn mức, chức năng lưu phản hồi vào bộ nhớ đệm, xử lý lỗi, v.v.
Sau khi sao chép kho lưu trữ và thiết lập môi trường (chỉ mất vài phút), bạn có thể dùng thử từng mẫu trong chưa đầy 1 phút. Vì mỗi mẫu tạo ra một bản sửa đổi mới của cùng một proxy nên môi trường của bạn sẽ không bị lộn xộn với nhiều mẫu. Bạn có thể chuyển đổi các bản sửa đổi, triển khai lại một bản sửa đổi khác trong giao diện người dùng quản lý và xem mã proxy bất cứ lúc nào. Readme cho mỗi mẫu cũng cung cấp cho bạn thông tin tóm tắt về hoạt động của mẫu và cách thiết lập mẫu.
Hãy dùng thử! https://github.com/apigee/api-platform-samples/tree/master/learn-edge
Mẫu sổ tay nấu ăn tài liệu
Chúng tôi cung cấp một loạt mẫu cho các chủ đề sổ tay nấu ăn proxy API.
Tên | Nội dung mô tả | Các Loại Chính sách | Tài nguyên |
---|---|---|---|
javascript-cookbook | Minh hoạ một đoạn mã JavaScript đơn giản giúp thêm tiêu đề HTTP từ các biến, chuyển đổi báo cáo thời tiết ở định dạng XML từ JSON sang XML và cắt bớt nội dung cho ứng dụng dành cho thiết bị di động. | Mini.js setHeaders.js |
|
javascript-mashup-cookbook | Một ứng dụng JavaScript hoàn chỉnh gọi đến các API công khai, kết hợp kết quả và tạo ra phản hồi chi tiết cho ứng dụng khách. (Lưu ý: proxy API này triển khai chức năng giống như kết hợp chính sách, chứng minh rằng có thể giải quyết cùng một vấn đề bằng nhiều kỹ thuật.) | JavaScript | MashItUp.js |
java-hello | Chú thích Java (Hello world) đơn giản. | JavaCallout | JavaHello.java |
java-cookbook | Chuyển đổi tiêu đề và nội dung phản hồi thành chữ hoa. | JavaCallout |
ResponseUppercase.java |
java-properties | Minh hoạ cách sử dụng các thuộc tính trong chú thích Java. | JavaCallout | JavaProperties.java |
lỗi java | Minh hoạ các mẫu xử lý lỗi mà bạn có thể sử dụng trong mã Chú thích Java. | JavaCallout | JavaError.java |
policy-mashup-cookbook | Một ứng dụng hoàn chỉnh dùng cấu trúc chính sách để gọi 2 API công khai, kết hợp kết quả và tạo phản hồi chi tiết cho ứng dụng. (Lưu ý: proxy API này triển khai chức năng giống như trình kết hợp JavaScript, chứng minh rằng có thể giải quyết cùng một vấn đề bằng nhiều kỹ thuật.) | AssignMessage ServiceCallout ExtractVariables JavaScript XMLToJSON |
GenerateResponse.js |
Proxy API mẫu
Các proxy API sau đây nằm trong GitHub, trong đó các trang readme cung cấp nội dung mô tả chi tiết về các mẫu. Nếu bạn quan tâm đến cách hoạt động của một chính sách cụ thể trong một mẫu, hãy xem cột Loại chính sách bên dưới để biết chính sách mà bạn quan tâm, sau đó nhấp vào tên mẫu trong cột Tên. (Các chính sách này được liên kết đến trang tham khảo tương ứng trong tài liệu.)
Tài liệu tham khảo và công cụ
Ngoài các ví dụ về sổ tay nấu ăn tài liệu và proxy mẫu trong các bảng trên, mẫu GitHub Edge cũng chứa các tài nguyên sau:
Tên | Nội dung mô tả | Các Loại Chính sách | Tài nguyên |
---|---|---|---|
rbảo vệ egex | Chính sách bảo vệ khỏi các mối đe doạ sử dụng biểu thức chính quy có thể bảo vệ các API phụ trợ và dịch vụ vi mô khỏi các cuộc tấn công chèn SQL. | Không áp dụng | |
oauth-validate-key-secret | Bạn đang triển khai quy trình cấp loại mật khẩu OAuth. Bạn cần xác thực cả khoá ứng dụng khách của ứng dụng và khoá bí mật trên Edge trước khi gọi một Nhà cung cấp danh tính bên ngoài để xác thực thông tin xác thực của người dùng. | OAuthV2, các ứng dụng khác | Không áp dụng |
điều kiện-khớp | Proxy này cho phép bạn dễ dàng dùng thử và kiểm thử các câu lệnh có điều kiện trong quy trình proxy API. | AssignMessage | Không áp dụng |
thực thể truy cập | Hướng dẫn cách truy xuất hồ sơ của các thực thể từ kho dữ liệu Apigee Edge. | AssignMessage AccessEntity ExtractVariables |
không có |
apikey | Triển khai xác thực khoá API đơn giản | VerifyAPIKey AssignMessage Hạn mức |
không có |
chú thích không đồng bộ | Minh hoạ chú thích không đồng bộ đơn giản bằng cách sử dụng JavaScript httpClient. | JavaScript | lắp ráp_phản hồi.js callout.js |
base64encoder | Minh hoạ cách gọi JavaScript bao gồm từ tài nguyên JavaScript trong proxy API. | AssignMessage JavaScript |
core-min.js enc-utf16-min.js enc-base64-min.js encryptedAuthHeader.js |
chính sách có điều kiện | Triển khai thực thi chính sách có điều kiện đơn giản. Khi một yêu cầu chứa tiêu đề HTTP responsetime:true, chính sách sẽ thực thi tập lệnh Python để thêm một tập hợp chỉ số hiệu suất vào thông báo phản hồi dưới dạng tiêu đề HTTP | Tập lệnh (Python) | timer.py |
điểm cuối động | Triển khai định tuyến có điều kiện đơn giản trong một tình huống phức tạp hơn một chút, theo đó xác định 2 URL và 1 tuyến mặc định. | không có | không có |
jira-release-notes (ghi chú phát hành của jira) | Đây là proxy API mà nhóm tài liệu Apigee dùng để tạo ghi chú phát hành của Jira. | JSONToXML XSL |
releasenotes_api.xsl |
kerberos-credential-ication | Mẫu này cho biết cách thực hiện Dàn xếp thông tin xác thực Kerberos trên Apigee Edge. | JavaCallout | Tệp JAR Java |
oauth-advanced | Một ví dụ hoàn chỉnh và hoạt động tốt về quy trình cấp mã uỷ quyền, trong đó Apigee Edge là máy chủ uỷ quyền. |
GenerateAccessToken Nhiều tệp khác... |
xem mã ví dụ |
OAuth-client-credentials (Thông tin xác thực khách hàng OAuth) | Minh hoạ điểm cuối của mã thông báo OAuth 2.0 đầy đủ chức năng được định cấu hình cho loại cấp thông tin đăng nhập ứng dụng. | GenerateAccessToken | không có |
OAuth-login-app | Không dùng nữa. Thay vào đó, bạn nên xem mẫu oauth-advanced. | ||
oauth-validate-key-secret | Minh hoạ kỹ thuật xác thực khoá và khoá bí mật của ứng dụng trước khi gọi một nhà cung cấp danh tính để xác thực thông tin đăng nhập của người dùng trong quy trình cấp loại mật khẩu. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
không có |
OAuth-verify-accesstoken | Hình minh hoạ một proxy API được định cấu hình để xác thực mã truy cập OAuth 2.0 và xác minh Hạn mức. | VerifyAccessToken Hạn mức |
không có |
OAuth10a-3 Bên | Minh hoạ cấu hình OAuth 1.0a ba chân. | GenerateAceessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
không có |
outbound-oauth | Sử dụng API trình biên dịch Microsoft Azure để dịch tweet. Để thực hiện việc này, trình bổ trợ sẽ thực hiện lệnh gọi đi để lấy mã truy cập OAuth, sau đó lưu mã thông báo vào bộ nhớ đệm bằng chính sách lưu vào bộ nhớ đệm của Dịch vụ API, sử dụng lại mã thông báo đã lưu vào bộ nhớ đệm mỗi khi có cuộc gọi đi. Ngoài ra, còn có một ứng dụng trình duyệt minh hoạ dùng để gọi proxy API. | AssignMessage LookupCache PopulateCache JavaScript |
api-config.js api-token-get.js translation-query.js translation-results.js |
phân trang | Phân trang một thông báo phản hồi XML dựa trên các tham số giới hạn và chênh lệch do ứng dụng cung cấp | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
phản hồi-bộ nhớ đệm | Minh hoạ cách lưu dự báo thời tiết vào bộ nhớ đệm trên Edge trong 10 phút. | ResponseCache AssignMessage |
không có |
simple-python | Minh hoạ một tình huống đơn giản về việc đính kèm một tập lệnh python trong phản hồi để thêm giá trị tiêu đề vào phản hồi đó. |
Tập lệnh (Python) | setHeader.py |
xà phòng | Minh họa phép chuyển đổi NDK ghi lại tệp WSDL để phản hồi yêu cầu có tham số truy vấn ?wsdl. | AssignMessage ExtractVariables Tập lệnh (Python) XSL |
segmentationaddress.py người sửa lỗi |
phát trực tuyến | Minh hoạ cấu hình phát trực tuyến HTTP. | không có | không có |
định tuyến lại mục tiêu | Minh hoạ việc sử dụng JavaScript để tự động chọn URL mục tiêu dựa trên nội dung của thông báo yêu cầu. | ExtractVariables JavaScript |
rewriteTargetUrl.js |
twitter-mobile-timeline | Minh hoạ cách sử dụng JavaScript để loại bỏ các tham số không cần thiết khỏi các bài đăng trên Twitter, từ đó rút ra một dòng thời gian đơn giản trên Twitter và thân thiện với các thiết bị di động bị hạn chế về tài nguyên. | AssignMessage JavaScript |
MobileTimeline.js |
twitter-oembed | Chuyển đổi phản hồi trong dòng thời gian (ví dụ: từ trạng thái/user_timeline.json) thành phản hồi oEmbedding chứa dữ liệu dòng thời gian dưới dạng nội dung HTML đa dạng thức. | AssignMessage JavaScript |
search-oembed.js |
biến | Minh hoạ cách trích xuất và đặt biến dựa trên nội dung thông báo truyền tải cũng như nội dung thông báo JSON và XML. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
xmltojson | Chuyển đổi dữ liệu phản hồi từ XML sang JSON. | XMLToJSON JSONToXML |
không có |
|
Bạn có thể dùng tệp giản đồ XML mà bạn có thể dùng làm tài liệu tham khảo khi định cấu hình proxy API, chính sách, sản phẩm API cũng như hồ sơ nhà phát triển và ứng dụng. |
||
|
Chứa công cụ triển khai triển khai.py sẽ nhập proxy API vào một tổ chức đang sử dụng Apigee Edge, sau đó triển khai nó vào môi trường được chỉ định. |
||
|
Công cụ tổng quan nhanh về tổ chức truy xuất các chế độ cài đặt của tổ chức, bao gồm cả nhà phát triển, sản phẩm API, máy chủ ảo, bản đồ khoá/giá trị, v.v. Bạn có thể dùng công cụ này để sao lưu thông tin chi tiết về một tổ chức hoặc khám phá các chế độ cài đặt trong một tổ chức. |
Apigee-127
Nếu bạn là một lập trình viên, Apigee-127 sẽ giúp bạn thiết lập và mã hoá proxy API bằng Node.js và Swagger. Bạn cũng có thể tìm các mẫu a127 trên GitHub: https://github.com/apigee-127/a127-samples.
Chia sẻ trải nghiệm của bạn
Chia sẻ trải nghiệm của bạn trên Diễn đàn nhà phát triển API.