현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
Apigee Edge API 샘플에는 아래 설명된 Apigee Edge API 서비스의 기능을 보여주는 샘플 API 프록시, 정책, 코드, 도구가 포함되어 있습니다.
샘플 사용에 대한 안내는 샘플 API 프록시 사용을 참조하세요.
직접 해보면서 배우기
Apigee Edge에 대한 탄탄한 기술 자료를 급하게 구축하고 싶으신가요? GitHub에 있는 'learn-edge' 샘플 라이브러리를 통해 일부 샘플 프록시를 빠르게 배포, 호출, 추적할 수 있습니다. 가장 간단한 프록시부터 API 키 유효성 검사, 할당량, 응답 캐싱, 오류 처리 등을 보여주는 프록시로 넘어갈 수 있습니다.
저장소를 클론하고 환경을 설정한 후 (몇 분 정도 소요) 1분 이내에 각 샘플을 사용해 볼 수 있습니다. 각 샘플에서 동일한 프록시의 새 버전을 만들기 때문에 샘플이 많아도 환경이 복잡하지 않습니다. 언제든지 버전을 전환하고, 관리 UI에서 다른 버전을 재배포하고, 프록시 코드를 볼 수 있습니다. 각 샘플의 리드미는 샘플의 작업과 설정 방법에 대한 간략한 요약도 제공합니다.
한번 사용해 보세요. https://github.com/apigee/api-platform-samples/tree/master/learn-edge
문서 설명서 샘플
API 프록시 설명서 주제에 대한 샘플 집합이 제공됩니다.
이름 | 설명 | 정책 유형 | 자료 |
---|---|---|---|
javascript-cookbook | 변수에서 HTTP 헤더를 추가하고, XML 형식의 날씨 보고서를 JSON에서 XML로 변환하고, 모바일 클라이언트의 콘텐츠를 자르는 간단한 자바스크립트 스니펫을 보여줍니다. | 최소화.js setHeaders.js |
|
javascript-mashup-cookbook | 공개 API를 호출하고 결과를 결합하며 클라이언트 앱의 보강된 응답을 생성하는 완전한 JavaScript 애플리케이션입니다(참고: 이 API 프록시는 정책 매시업과 동일한 기능을 구현하여 동일한 문제를 다른 기법을 사용해 해결할 수 있음을 보여줍니다.) | JavaScript | MashItUp.js |
java-hello | 간단한 Hello World 자바 콜아웃입니다. | JavaCallout | JavaHello.java |
java-cookbook | 응답 내용과 헤더를 대문자로 변환합니다. | JavaCallout |
ResponseUppercase.java |
java-properties | 자바 콜아웃에서 속성을 사용하는 방법을 보여줍니다. | JavaCallout | JavaProperties.java |
자바-오류 | 자바 콜아웃 코드에서 사용할 수 있는 오류 처리 패턴을 보여줍니다. | JavaCallout | JavaError.java |
policy-mashup-cookbook | 정책 구성을 사용하여 두 개의 공개 API를 호출하고 결과를 결합하며 클라이언트 앱의 보강된 응답을 생성하는 완전한 애플리케이션입니다. 참고: 이 API 프록시는 자바스크립트 매시업과 동일한 기능을 구현하여 동일한 문제를 다른 기법을 사용해 해결할 수 있음을 보여줍니다. | AssignMessage ServiceCallout ExtractVariables 자바스크립트 XMLToJSON |
GenerateResponse.js |
샘플 API 프록시
다음 API 프록시는 GitHub에 있으며, 리드미 페이지에서 샘플에 대한 자세한 설명을 제공합니다. 특정 정책이 샘플에서 어떻게 작동하는지 알아보려면 아래의 정책 유형 열에서 관심 있는 정책을 찾은 후 이름 열에서 샘플 이름을 클릭하세요. 정책은 문서의 해당 참조 페이지에 링크되어 있습니다.
참조 및 도구
위 표에 있는 문서 설명서 샘플 및 샘플 프록시 외에도 Edge GitHub 샘플에 다음 리소스가 포함되어 있습니다.
이름 | 설명 | 정책 유형 | 자료 |
---|---|---|---|
egex-protection | 정규 표현식 위협 방지 정책은 SQL 주입 공격으로부터 백엔드 API와 마이크로서비스를 보호할 수 있습니다. | N/A | |
oauth-validate-key-secret | OAuth 비밀번호 부여 유형 흐름을 구현하고 있습니다. 외부 ID 공급업체를 호출하여 사용자 인증 정보를 검증하기 전에 Edge의 애플리케이션 클라이언트 키와 보안 비밀을 모두 검증해야 합니다. | OAuthV2 등 | N/A |
조건-패턴-일치 | 이 프록시를 사용하면 API 프록시 흐름에서 조건문을 쉽게 사용해 보고 테스트할 수 있습니다. | AssignMessage | N/A |
access-entity입니다. | Apigee Edge 데이터 스토어에서 항목의 프로필을 검색하는 방법을 보여줍니다. | AssignMessage AccessEntity ExtractVariables |
없음 |
apikey | 간단한 API 키 검증 구현 | VerifyAPIKey AssignMessage 할당량 |
없음 |
async-callout | 자바스크립트 httpClient를 사용하는 간단한 비동기 콜아웃을 보여줍니다. | JavaScript | compile_response.js callout.js |
base64encoder | API 프록시의 JavaScript 리소스에서 JavaScript Include를 호출하는 방법을 보여줍니다. | AssignMessage 자바스크립트 |
core-min.js enc-utf16-min.js enc-base64-min.js encodedAuthHeader.js |
conditional-policy | 간단한 조건부 정책 적용을 구현합니다. 요청에 HTTP 헤더 Responsetime:true가 포함된 경우 정책은 응답 메시지에 성능 측정항목 집합을 HTTP 헤더로 추가하는 Python 스크립트를 실행합니다. | 스크립트(Python) | timer.py |
dynamic-endpoint | 두 개의 URL과 하나의 기본 경로를 정의하는 약간 더 복잡한 시나리오에서 간단한 조건부 라우팅을 구현합니다. | 없음 | 없음 |
jira-release-notes | Apigee 문서팀에서 Jira의 출시 노트를 생성하는 데 사용하는 API 프록시입니다. | JSONToXML XSL |
releasenotes_api.xsl |
kerberos-credential-미디에이션 | 이 샘플은 Apigee Edge에서 Kerberos 사용자 인증 정보 미디에이션을 수행하는 방법을 보여줍니다. | JavaCallout | 자바 JAR 파일 |
oauth-advanced | Apigee Edge를 승인 서버로 사용하는 승인 코드 부여 유형 흐름의 전체 실제로 작동하는 예시입니다. |
GenerateAccessToken 기타 다수 |
예시 코드 보기 |
oauth-client-credentials | 클라이언트 사용자 인증 정보 부여 유형에 맞게 구성된 모든 기능을 갖춘 OAuth 2.0 토큰 엔드포인트를 보여줍니다. | GenerateAccessToken | 없음 |
oauth-login-app | 지원이 중단되었습니다. 대신 oauth-advanced 샘플을 살펴보는 것이 좋습니다. | ||
oauth-validate-key-secret | 비밀번호 부여 유형 흐름에서 ID 공급업체를 호출하여 사용자 인증 정보를 검증하기 전에 클라이언트의 키와 보안 비밀을 검증하는 기법을 설명합니다. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
없음 |
oauth-verify-accesstoken | OAuth 2.0 액세스 토큰을 검증하고 할당량을 확인하도록 구성된 API 프록시를 보여줍니다. | VerifyAccessToken 할당량 |
없음 |
oauth10a-3legged | OAuth 1.0a 3각 구성을 보여줍니다. | GenerateAceessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
없음 |
outbound-oauth | Microsoft Azure translator API를 사용하여 트윗을 번역합니다. 이를 위해 OAuth 액세스 토큰을 얻기 위해 아웃바운드 호출을 실행한 다음, API 서비스 캐싱 정책을 사용하여 토큰을 캐시하고 아웃바운드 호출이 있을 때마다 캐시된 토큰을 재사용합니다. 또한 API 프록시를 호출하는 데 사용되는 데모 브라우저 앱도 포함되어 있습니다. | AssignMessage LookupCache PopulateCache 자바스크립트 |
api-config.js api-token-get.js translate-query.js translate-results.js |
페이지로 나누기 | 클라이언트가 제공하는 제한 및 오프셋 매개변수를 기반으로 XML 응답 메시지를 페이지로 나눕니다. | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
응답 캐시 | Edge에서 일기예보를 10분 동안 캐시하는 방법을 보여줍니다. | ResponseCache AssignMessage |
없음 |
simple-python | 헤더 값을 추가하는 응답에 Python 스크립트를 첨부하는 간단한 시나리오를 보여줍니다. |
스크립트(Python) | setHeader.py |
soap | 쿼리 매개변수 ?wsdl을 사용한 요청에 대한 응답으로 WSDL 파일을 다시 쓰는 XSL 변환을 보여줍니다. | AssignMessage ExtractVariables Script (Python) XSL |
computeaddress.py fixwsdl.xls |
스트리밍 | HTTP 스트리밍 구성을 보여줍니다. | 없음 | 없음 |
target-reroute(타겟 경로 변경) | JavaScript를 사용하여 요청 메시지의 콘텐츠를 기반으로 타겟 URL을 동적으로 선택하는 방법을 보여줍니다. | ExtractVariables 자바스크립트 |
rewriteTargetUrl.js |
twitter-mobile-timeline | 자바스크립트를 사용하여 트윗에서 불필요한 매개변수를 제거하여 리소스가 제한된 휴대기기에서도 적합한 간소화된 Twitter 타임라인을 만드는 방법을 보여줍니다. | AssignMessage 자바스크립트 |
MobileTimeline.js |
twitter-oembed | 타임라인 응답 (예: status/user_timeline.json의)을 타임라인 데이터를 리치 HTML 콘텐츠로 포함하는 oEmbed 응답으로 변환합니다. | AssignMessage JavaScript |
search-oembed.js |
변수 | 전송 및 JSON 및 XML 메시지 콘텐츠를 기반으로 변수를 추출하고 설정하는 방법을 보여줍니다. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
xmltojson을 참조하세요. | 응답 데이터를 XML에서 JSON으로 변환합니다. | XMLToJSON JSONToXML |
없음 |
|
API 프록시, 정책, API 제품, 개발자, 앱 프로필을 구성할 때 참조로 사용할 수 있는 XML 스키마 파일입니다. |
||
|
Apigee Edge의 조직으로 API 프록시를 가져온 다음 지정된 환경에 배포하는 배포 도구인 deploy.py가 포함되어 있습니다. |
||
|
조직 스냅샷 도구는 개발자, API 제품, 가상 호스트, 키/값 맵 등을 포함한 조직 설정을 검색합니다. 조직의 세부정보를 백업하거나 조직의 설정을 검색하는 데 사용할 수 있습니다. |
Apigee-127
코더는 Apigee-127을 사용하여 Node.js 및 Swagger로 API 프록시를 시작하고 코딩할 수 있습니다. GitHub(https://github.com/apigee-127/a127-samples)에서 a127 샘플도 찾을 수 있습니다.
내 경험 공유하기
Apigee 개발자 포럼에서 경험을 공유하세요.