Skip to main content

커스텀 API

사용자가 정의한 API를 호출하는 노드입니다.

설명​

커스텀 API 노드는 외부 API를 직접 호출하여 데이터를 가져올 수 있는 노드입니다.

URL, HTTP 메서드, 헤더, 본문 등을 자유롭게 설정하여 다양한 REST API를 호출할 수 있습니다. Single 모드와 Dataset 모드를 지원하며, JSON 응답을 자동으로 CSV로 변환하는 기능도 제공합니다.

포트 구성​

입력 포트​

  • 데이터셋 (Dataset 모드 선택 시): API 요청에 사용할 데이터

출력 포트​

  • 데이터셋: API 응답 데이터가 포함된 데이터셋

속성​

요청 모드​

API 호출 방식을 선택합니다:

  • 단일 요청: 단일 API 호출 (속성 직접 입력)
  • 데이터셋 요청: 입력 데이터셋의 각 행마다 API 호출 (컬럼 선택)

URL​

  • 단일 요청: 호출할 API의 엔드포인트 URL을 입력합니다
  • 데이터셋 요청: URL이 포함된 데이터셋의 컬럼을 선택합니다

예시: https://api.example.com/data

Method​

  • 단일 요청: HTTP 메서드를 선택합니다
  • 데이터셋 요청: HTTP 메서드가 포함된 데이터셋의 컬럼을 선택합니다

사용 가능한 메서드:

  • GET: 데이터 조회
  • POST: 데이터 생성
  • PUT: 데이터 전체 수정
  • PATCH: 데이터 일부 수정
  • DELETE: 데이터 삭제

Headers​

  • 단일 요청: HTTP 요청 헤더를 JSON 형식으로 입력합니다
  • 데이터셋 요청: 헤더 정보가 포함된 데이터셋의 컬럼을 선택합니다

예시:

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

Body​

  • 단일 요청: HTTP 요청 본문을 입력합니다. POST, PUT, PATCH 메서드 사용 시 필요합니다
  • 데이터셋 요청: 요청 본문이 포함된 데이터셋의 컬럼을 선택합니다

예시:

{
  "key": "value",
  "name": "example"
}

자동 변환(JSON -> CSV, CSV -> JSON)​

API 응답이 JSON 형식일 때 자동으로 CSV 형식으로 변환할지 선택합니다.

  • 켜짐: JSON 응답을 테이블 형태로 자동 변환
  • 꺼짐: 원본 JSON 응답 그대로 반환

사용 방법​

단일 요청​

  1. 노드를 캔버스에 추가합니다
  2. 요청 모드에서 단일 요청을 선택합니다
  3. URL을 입력합니다
  4. Method를 선택합니다
  5. (필요시) Headers를 입력합니다
  6. (필요시) Body를 입력합니다
  7. 자동 변환 설정을 선택합니다
  8. 실행하기 버튼을 클릭합니다
  9. 출력 포트에서 API 응답 데이터를 확인할 수 있습니다

데이터셋 요청​

  1. 노드를 캔버스에 추가합니다
  2. API 요청 정보가 포함된 데이터셋을 입력 포트에 연결합니다
  3. 요청 모드에서 데이터셋 요청을 선택합니다
  4. URL 컬럼에서 URL이 있는 컬럼을 선택합니다
  5. (필요시) Method 컬럼에서 메서드가 있는 컬럼을 선택합니다
  6. (필요시) Headers 컬럼에서 헤더가 있는 컬럼을 선택합니다
  7. (필요시) Body 컬럼에서 본문이 있는 컬럼을 선택합니다
  8. 자동 변환 설정을 선택합니다
  9. 실행하기 버튼을 클릭합니다
  10. 출력 포트에서 각 행마다 호출된 API 응답 데이터를 확인할 수 있습니다

주의사항​

API 키 보안

API 키나 토큰은 민감한 정보입니다. headers에 포함할 때 주의하세요.

데이터셋 요청

데이터셋 요청에서는 입력 데이터셋의 각 행마다 API를 호출하므로, 많은 요청이 발생할 수 있습니다.