API Sandbox 가상화 고객 교육
Sandbox 가상화란?
API Sandbox 가상화는 라이브 Sandbox 인스턴스의 동작을 시뮬레이션하는 서비스입니다. 저희의 가상화 서비스는 귀하가 받는 응답이 미리 지정되어 있고 특정 입력 값에 따라 달라지지 않는 일관된 환경을 제공합니다.
예를 들어, 예를 들어, 발송인과 수취인의 위치만 변경하여 각 테스트마다 동일한 속도 요청을 했다고 가정해 보겠습니다. API는 주소 변경과 상관없이 미리 지정된 동일한 속도 응답을 반환할 것입니다. 값이 일치하지 않더라도 응답 구조는 귀하가 라이브 환경에서 수신하는 환경을 시뮬레이션합니다.
가상화 서비스가 라이브 백엔드 시스템 구성요소에 도달하지 않기 때문에 적절한 응답을 얻는 동안 통합 테스트는 백엔드 종속성으로부터 보호됩니다.
FedEx Sandbox를 가상화하는 이유는?
FedEx와 같이 복잡하고 상호의존적인 시스템에서는 간혹 중요한 리소스를 사용할 수 없거나 시스템을 이용할 수 없는 경우가 발생할 때가 있습니다. 이런 사고는 멀리 떨어진 곳에서 발생한 경우에도 API 통합 테스팅에 부정적인 영향을 줄 수 있습니다. 실제 인스턴스 중에서 다음과 같이 통합 테스팅의 범위를 제한할 수 있는 기타 제약 조건이 있습니다.
- 발송 고객번호에 특정 시나리오를 테스트하는 데 필요한 필수 액세스 권한이 없음
- 테스트 데이터 가용성 제한
- 계획되거나 계획되지 않은 시스템 다운타임
가상화된 Sandbox 인스턴스는 어떻게 사용하나요?
- API 문서, 엔드포인트 및 인증 방법을 숙지하십시오. 효과적인 테스트를 설계하는 데 도움이 됩니다.
- API 문서에서 제공되는 JSON API 컬렉션을 다운로드하고 숙지하십시오.
- 사용 옵션에 맞는 샘플 트랜잭션을 선택하고 테스트하십시오. 일관된 환경을 통한 가상 응답을 받기 위해, 요청 페이로드 구조를 변경하지 마십시오.
- 모든 입력 값이 응답에 영향을 미치는 것은 아닙니다. 대신에 응용 프로그램이 일관된 응답을 처리하는 방법을 이해하는 데 집중하세요.
- 문서를 바탕으로 모든 API가 올바른 동작을 하는지 테스트하십시오. 긍정 및 부정 케이스를 모두 테스트하십시오.
- 제공된 부정 테스트 케이스를 사용하여 오류 메시지와 상태 코드가 어떻게 반환되는지 이해하십시오. 응용 프로그램이 오류를 관리하는 방법을 정하는 데 도움이 됩니다. JSON API 컬렉션 및 'Negative'라는 접두사가 추가된 테스트 케이스를 참조하십시오.
가상화의 이점
- 리소스를 사용할 수 없게 될 가능성이 감소
- 테스트 데이터 종속성 감소
- 라이브 Sandbox 인스턴스에 비해 응답이 더 빠름
- 특별 서비스에 대해 고객번호 단계의 액세스 불필요
- 원활한 연동 환경을 제공하여, 테스트 및 인증 프로세스 간소화
FAQ
- 요청 페이로드를 가상화된 응답에 적용하려면 어떻게 해야 하나요?
각 API 문서에는 JSON API 컬렉션이 제공됩니다. API 카탈로그를 방문하여 API 문서를 엽니다. API 문서의 "JSON API 컬렉션" 섹션을 참조하십시오. JSON API 컬렉션에는 가상화된 응답을 검색할 수 있는 모든 요청 페이로드가 저장되어 있습니다. - 가상화된 Sandbox 인스턴스에 접근하려면 토큰이 필요한가요?
예, 토큰 생성 및 승인은 그대로 작동하며 가상화된 Sandbox 서비스와 상호작용하는 모든 트랜잭션에 대해 토큰을 전달해야 합니다. - 응답이 가상화된 서비스에서 반환됐다는 걸 어떻게 알 수 있나요?
가상화된 응답은 페이로드의 일부로 하위 경고문이 추가됩니다.
- 요금 및 배송 시간 API에서 요청 페이로드에 있는 제 주소가 확인되지 않는 이유는 무엇인가요?
주소 유효성 확인은 가상 응답을 도출하는 로직의 일부가 아닙니다. 국가만 확인되므로 나머지 주소 필드에 값을 전달할 수 있습니다. - 모든 API가 가상화되나요?
현재까지 가상화된 API는 다음과 같습니다. 나머지 API 기능을 가상화하는 작업이 진행 중입니다.
요금 및 배송 시간 API | 가상화됨 |
배송 조회 API | 가상화됨 |
Freight LTL API – 요금 및 픽업 기능 | 가상화됨 |
주소 확인 API | 가상화됨 |
우편번호 확인 API | 가상화됨 |
픽업 요청 API | 가상화됨 |
서비스 이용 가능성 API | 가상화됨 |
글로벌 무역 API | 가상화됨 |
Ground 당일 업무 종료 API | 가상화됨 |
Open Ship API | 가상화됨 |
발송 API | 가상화됨 |
FedEx 접수처 검색 API | 가상화됨 |