사용자정의 API 테스트

Oracle Mobile Hub에서 모의 데이터를 사용하여 배포되기 전에 사용자정의 API를 테스트할 수 있습니다. 표준 테스트와 고급 테스트의 두 가지 모드를 지원하는 테스트 페이지를 사용하여 REST 커넥터를 테스트할 수도 있습니다.

Oracle Mobile Hub 사용자정의 API 테스트

Oracle Mobile Hub에서 직접 사용자정의 API를 테스트하려면 다음을 수행합니다.

Oracle Mobile Hub에 사인인합니다.
메뉴 아이콘을 누른 다음 개발을 확장하고 백엔드를 누릅니다.
모바일 백엔드를 선택하고 열기를 누릅니다.
왼쪽 탐색 모음에서 설정을 누릅니다.
환경 URL 아래에 있는 SSO 토큰 끝점에서 URL을 복사합니다.
복사한 URL을 웹 브라우저 창에 붙여넣지만 Enter 키를 누르지 마십시오.
OAuth 소비자 섹션 아래에 있는 클라이언트 ID를 복사합니다.
웹 브라우저에서 ?clientID=[YourClientID] 형식으로 붙여넣은 SSO 토큰 끝점 URL에 질의 문자열 매개변수를 추가한 다음 Enter 키를 누릅니다. URL의 예는 다음과 같습니다.
```
https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>
```
브라우저에 Single Sign-On OAuth 토큰이 표시됩니다.
모바일 백엔드 창에서 왼쪽 탐색에 있는 API 페이지를 누릅니다. 브라우저가 설정 페이지에서 API 페이지로 변경됩니다.
API 선택을 누릅니다.
테스트할 API 이름을 누릅니다. 요청 및 응답 탭과 왼쪽 탐색에 API 끝점을 표시하는 새 페이지가 열립니다.
테스트할 끝점을 누릅니다.
인증 섹션의 인증 방법에서 단일 사인온 토큰을 선택합니다.
SSO OAuth 토큰을 복사하여 Single Sign-On 토큰 필드에 붙여 넣으십시오.
끝점 테스트를 누릅니다. 모든 것이 올바르면 서버가 200 상태로 응답하므로 응답에 JSON 데이터가 표시됩니다.

모의 데이터를 사용하여 API 끝점 테스트

API 구성 설계 단계에서 요청 및 응답 메시지 본문에 모의 데이터를 제공할 수 있습니다. 이렇게 하면 실시간 데이터를 사용하거나 실시간 서비스와 상호 작용하지 않고도 각 호출의 컨텍스트를 검사할 수 있습니다. 예를 들어, 코드가 부적합한 ID를 올바르게 처리하는지 테스트하기 위해 요청 본문에 부적합한 ID를 포함하는 모의 데이터가 있는 예를 추가할 수 있습니다. 테스트를 완료하면 예제를 다른 코드로 바꾸어 메소드의 다른 측면을 테스트할 수 있습니다.

FixItFast 예에서 응답 본문의 모의 데이터를 통해 올바른 고객 정보가 반환되는지 확인할 수 있습니다. 다음은 서비스 개발자가 FixItFast 예제에서 contact 리소스의 POST 작업 응답 본문에 대해 생성할 수 있는 모의 데이터 예입니다.

{
 "id": 20934,
 "title": "Lynn's Leaking Water Heater",
       "contact": {
       "name": "Lynn Adams",
       "street": "45 O'Connor Street",
       "city": "Ottawa",
       "postalcode": "ala1a1"
       "username":"johneta"
       }
 "status": "new",
 "driveTime": 30,
 "priority": "high",
 "createdon": "2015-04-23 18:12:03 EDT"
}

사용자정의 API를 생성하면 모의 구현이 자동으로 생성됩니다. 모의 구현을 통해 사용자정의 코드를 구현하기 전에 모바일 애플리케이션에서 API를 호출할 수 있습니다. 이를 통해 모바일 애플리케이션과 사용자정의 코드를 동시에 개발하고 테스트할 수 있습니다. 구성에 만족하면 실제 구현을 추가할 수 있습니다.

첫번째 구현을 생성할 때까지 기본 구현은 모의 구현입니다. 실제 구현을 생성하면 API의 기본 구현이 됩니다.

구현 탐색 링크를 눌러 구현을 업로드하거나 기존 구현을 확인합니다. 구현 페이지에서 기본 구현을 변경할 수 있습니다. 구현을 업로드하면 모의 구현을 포함하는 기존 구현 목록이 표시됩니다.

REST 커넥터 API 테스트

REST 커넥터 API를 정의하고 구성을 저장했으므로 요청을 전송할 수 있는지 확인하고 웹 서비스에서 예상 결과를 수신할 수 있습니다. 연결 테스트는 선택적인 단계이지만 커넥터 API를 완료하기 전에 지금 문제를 식별하고 수정하여 시간을 절약할 수 있습니다. [테스트] 페이지에서는 한 번에 하나의 끝점을 테스트할 수 있습니다.

기술자를 제공한 경우 다음 두 가지 테스트 모드를 선택할 수 있습니다.

표준 테스트

기술자 메타데이터를 제공한 경우 요청 및 응답 본문이 설명 메타데이터에서 생성되고 요청 및 응답 탭에 표시되는 표준 테스트 모드가 표시됩니다. GET 메소드에 대해 테스트할 매개변수를 선택하고 테스트할 HTTP 헤더를 포함하면 됩니다.
고급 테스트

고급 모드에서 테스트(원격 서비스 URL을 제공한 경우 입력한 테스트 모드)를 선택하여 테스트를 세분화할 수 있습니다. 설명 메타데이터가 없으면 테스트할 메소드 및 리소스를 선택하고, 포함할 HTTP 헤더를 포함시키고, JSON 본문을 수동으로 생성합니다.

고급 모드로 테스트

고급 테스트 페이지에서는 경로 매개변수, 헤더 추가, 요청 및 응답 페이로드를 수동으로 설정할 수 있습니다.

커넥터 테스트를 수동으로 구성하려면 다음과 같이 하십시오.

테스트 탐색 링크를 누릅니다.
기술자를 제공한 경우 고급 모드에서 테스트를 On로 설정합니다.

원격 서비스 URL을 제공한 경우 고급 테스트 페이지가 자동으로 표시됩니다.
드롭다운 목록에서 테스트할 HTTP 메소드를 선택합니다.
테스트 목적으로 필요한 경우 Local URI 필드에서 리소스 경로 매개변수를 지정합니다. 예:
```
directions/json?origin=los+angeles&destination=seattle
```
API 이름을 입력할 때 정의한 로컬 URI가 필드에 자동으로 접두어로 붙습니다. 이 예에 따라 필드의 전체 내용은 다음과 같습니다.
```
myMapAPI /directions/json?origin=los+angeles&destination=seattle
```
규칙을 정의한 경우 적용된 규칙 필드(본문 필드 아래)에는 선택한 작업에 적용할 수 있는 규칙에 해당하는 번호가 표시됩니다. Remote URL 필드에는 테스트를 위해 서비스에 전달될 정확한 문자열이 표시됩니다.
필요에 따라 하나 이상의 요청 또는 응답 HTTP 헤더를 추가합니다.

이러한 헤더는 테스트 목적으로만 사용되며 REST 커넥터 API 구성에 추가되지 않습니다.
HTTP 본문 필드를 눌러 소스 편집기에서 메시지 본문(페이로드)을 생성합니다.
예:
```
{
  "status":"ZERO_RESULTS",
  "routes":[ ]
}
```
메시지 본문의 콘텐츠가 커넥터의 목적과 관련되도록 합니다. 즉, 관련 없는 데이터를 추가하여 메시지를 피우지 마십시오. 메시지 본문에 관련 데이터만 포함하면 요청 또는 응답을 빠르게 전송할 수 있습니다.
연결하려는 서비스에 인증이 필요한 경우 인증 섹션을 열고 테스트하는 각 방법에 대해 모바일 사용자 인증서를 입력합니다. 기본 테스트 인증서를 사용하는 경우 이 단계를 건너뛸 수 있습니다.

SAML 기반 보안 정책을 사용하면 호출하는 사용자의 ID가 외부 서비스로 전파됩니다. HTTP 기본 인증 및 사용자 이름 토큰과 같은 기타 보안 정책의 경우 외부 서비스로 인증하는 데 사용되는 인증서가 정책 무효화에서 CSF 키로 제공됩니다. 정의한 작업에 따라 각 작업에 대해 특정 인증서를 입력해야 하거나 모든 메소드에 대해 하나의 인증서 집합을 사용하여 서비스에서 커넥터를 인증할 수 있습니다.
현재 모바일 백엔드 기본 인증서로 저장을 눌러 기본값으로 제공하는 사용자 이름과 비밀번호를 저장합니다.
커넥터 생성의 설계 단계에 있고 끝점이 적합한지 확인하려는 경우 기본 API 디자이너 테스트 인증서를 누르고 등록한 모바일 백엔드와 해당 버전 번호를 선택합니다.
선택적으로 모바일 사용자 인증서(사용자 이름 및 비밀번호)를 입력할 수 있습니다.
이러한 기본 테스트 인증서는 테스트하는 모든 메소드에서 유지됩니다. 현재 Mobile Hub 세션 동안 유효한 상태로 유지됩니다.
끝점 테스트를 누릅니다.

테스트 끝점을 누르면 테스트 취소로 토글됩니다. 어떤 이유로든 테스트를 중지하려면 테스트 취소를 누릅니다.

재설정을 눌러 필드를 지우고 테스트 매개변수를 수정합니다.
끝점 테스트를 마쳤으면 완료를 누릅니다.