REST API에 연결

마지막 업데이트 날짜: 2025년 3월 17일

REST API에 연결하기

REST API 커넥터는 연결을 생성하기 위해 특정 정보가 필요합니다 Data Virtualization.

더 자세한 정보는 Data Virtualization 의 객체 저장소의 데이터 소스를 참고하세요.

시작하기 전에

REST API 와의 연결을 설정하려면 다음 연결 세부 정보가 필요합니다

호스트 이름 URL

프로시저

REST API 에 연결하려면 Data Virtualization, 다음 단계를 따르십시오.

네비게이션 메뉴에서 ' 데이터 > Data virtualization'를 클릭합니다. ' 데이터 소스 ' 페이지가 나타납니다.
연결 추가 > 새 연결을 클릭하여 데이터 소스 목록을 확인합니다.
REST API 데이터 소스 연결을 선택하십시오.
연결 이름 및 설명을 입력하십시오.
호스트 데이터베이스의 호스트 이름( URL )을 입력합니다. REST API 데이터 소스에 연결하는 두 가지 방법, 즉 샘플 속성 방법과 모델 파일 방법을 선택할 수 있습니다.

속성 메서드 예제

샘플 프로퍼티 방법을 사용하는 경우, 호스트 이름의 엔드포인트를 다음과 같이 지정하십시오. URL : https://domain.example.com/api/v1/employee_name. 샘플 프로퍼티 메서드를 사용하면 최소한의 설정으로 단일 엔드포인트의 데이터에 액세스할 수 있습니다. 모델 파일을 제공할 필요가 없습니다.
모델 파일 방식
- 모델 파일 방식을 사용하는 경우, 여러 엔드포인트에서 데이터에 액세스할 수 있도록 호스트 이름(https://domain.example.com)의 기본 도메인( URL )을 입력하십시오.
- 이 방법을 사용하려면 모델 파일을 수동으로 생성한 다음, 그 파일을 모델 파일 필드 에 붙여넣어야 합니다. 모델 파일을 만들고 엔드포인트를 표에 매핑하려면 모델 파일 구문 에서 설명하는 단계를 따르십시오 엔드포인트를 테이블에 매핑하는 기본 형식에 대한 참고 자료는 모델 파일 만들기의 예를 참조하십시오.
- HTTP 상태 코드를 처리하는 방법이나 GET 요청에 대한 다양한 설정 등, 사용자의 환경에 맞게 모델 파일을 수정할 수 있습니다. REST API 데이터 소스의 경우, 예제 모델 파일에 나와 있는 것처럼 POST 요청이나 인증 객체가 필요하지 않습니다.
다음의 태스크를 완료하십시오.
- 쿼리 파라미터로 구성된 API 키 인증을 사용합니다
  API 키 인증을 사용하려면, 이 단계를 완료하기 전에 데이터 소스가 쿼리 파라미터로 API 키 전달을 지원하는지 확인하십시오.
  
  API 키 인증을 사용하려면 호스트 URL 에 API 키를 직접 추가하십시오.
  예를 들어, 이 예제( URL )에서 <your_api_key>를 API 키로 대체합니다.
  https://api.example.com/resource?apikey=<your_api_key>
  
  인증 방법에서 "없음" 을 선택합니다.
  헤더 파라미터로 구성된 API 키 인증을 사용합니다
  헤더 파라미터로 설정된 API 키 인증을 사용하려면 다음 단계를 완료하십시오.
  
  추가 속성 필드 에 다음 매개 변수를 입력합니다. API 키를 <your_api_key>로 대체하십시오.
  AuthenticationMethod=HttpHeader;SecurityToken=ApiKey<your_api_key>
  
  인증 방법에서 "없음" 을 선택합니다.
  다른 인증 방법 사용(기본, 없음 또는 무기명 토큰)
  다른 인증 방법을 사용하려면 이 단계를 완료하십시오.
  
  인증 정보에서 인증 방법(기본, 없음, 또는 베어러 토큰)을 선택하고 필요한 인증 정보를 입력합니다.
연결에 사용자 지정 SSL 인증서가 필요한 경우, SSL 인증서 필드 에 인증서를 입력합니다.
데이터 소스 환경에 연결을 추가하려면 작성을 클릭하십시오.