API 호출 노드

한눈에 보기

API 호출 노드는 워크플로우 실행 중 외부 시스템의 REST API를 호출합니다. ERP, SCM, WMS 등 기존 시스템과 데이터를 주고받을 때 사용하며, 요청/응답 매핑을 통해 코드 없이 연동할 수 있습니다.

소개

제조업에서는 다양한 시스템이 공존합니다. API 호출 노드를 활용하면:

• ERP 연동: SAP, Oracle 등에서 자재 정보, 구매 주문 조회
• WMS 연동: 창고관리시스템에 입출고 요청
• SCM 연동: 공급망 시스템에 발주 전송
• MES 연동: 타사 MES에서 생산 실적 수집

이렇게 보입니다

설정 화면

API 호출 노드 설정

요청

메서드POST

URLhttps://erp.company.com/api/v1/purchase-orders

헤더

Content-Typeapplication/json

AuthorizationBearer {auth_token}

요청 본문 (Body)

{ "item_code": "{품목코드}", "quantity": {수량}, "delivery_date": "{납기일}", "warehouse": "{입고창고코드}" }

인증 설정

인증 방식	설명
None	인증 없음 (내부 네트워크)
API Key	헤더 또는 쿼리 파라미터에 키 전달
Bearer Token	Authorization 헤더에 토큰 전달
Basic Auth	사용자명/비밀번호 기반 인증
OAuth2	OAuth2 토큰 자동 갱신

응답 매핑

API 응답(JSON)의 특정 필드를 워크플로우 변수에 매핑합니다:

응답 매핑

API 응답 필드		워크플로우 변수
$.order_id	→	{발주번호}
$.status	→	{발주상태}
$.estimated_date	→	{예상입고일}
$.total_amount	→	{총금액}

설정 방법

1. 캔버스에서 API 호출 노드를 배치합니다.
2. HTTP 메서드를 선택합니다 (GET / POST / PUT / DELETE).
3. URL을 입력합니다 — {변수}로 동적 경로 구성 가능.
4. 인증 방식을 설정합니다.
5. POST/PUT의 경우 요청 본문을 작성합니다.
6. 응답 매핑으로 API 결과를 변수에 저장합니다.
7. 테스트 실행으로 동작을 확인합니다.

타임아웃 설정

외부 API 호출 시 네트워크 지연이 발생할 수 있습니다. 기본 타임아웃은 30초이며, 필요 시 조정하세요. 타임아웃 발생 시 워크플로우는 오류 상태로 전환됩니다.

오류 처리

API 호출 실패 시 동작을 설정할 수 있습니다:

• 재시도: 지정 횟수만큼 재시도 (1~5회, 간격 설정 가능)
• 대체 경로: 오류 시 다른 워크플로우 경로로 이동
• 중단: 워크플로우 즉시 중단

실무 예시: ERP 구매 발주 자동 생성

시나리오: 자재 부족 감지 시 ERP에 자동으로 구매 발주를 생성

자재 부족 감지 (자동 작업)

▼

API 호출: ERP 구매 발주 생성
POST https://erp.company.com/api/v1/purchase-orders
Body: { item_code, quantity, delivery_date }
응답: { order_id, status }

◆ 응답 상태?

성공 (status == "created")

발주번호 저장 (자동 작업)

→ ◎ 종료

실패

구매팀 수동 발주 요청 (사람 작업)

→ ◎ 종료

다음 단계

• 웹훅 노드 — 외부 시스템에서 VEXPLOR로 데이터 수신
• 데이터 변환 — API 응답 데이터 가공