Webhook / API Input

카테고리: 입출력 데이터 · 노드 타입 ID: input-webhook-api

HTTP 페이로드 또는 웹훅 응답을 워크플로우로 가져온다

개요

외부 HTTP/HTTPS 엔드포인트에 요청(GET 또는 POST)을 보내거나, 네트워크 요청이 실패·차단되었을 때 미리 정의한 오프라인 폴백 페이로드(Fallback Payload)를 바이트 배열로 내보낸다.

외부 키 서버, 엔트로피 비콘(예: drand), 또는 REST API의 응답 데이터를 워크플로우로 가져올 때 사용한다.

파라미터 (ID)	타입 및 기본값	노출 조건	설명 및 옵션
엔드포인트 URL `url`	`text` 기본값: `https://httpbin.org/get` 변수 참조 지원 (`$var`: `string`)	항상 노출	요청을 보낼 대상 HTTP/HTTPS URL이다. 비워 두면 네트워크 요청 없이 즉시 `fallbackPayload`를 반환한다.
HTTP 메서드 `method`	`select` 기본값: `GET`	항상 노출	사용할 HTTP 메서드(`GET` 또는 `POST`)이다. `GET`: HTTP GET 요청을 보낸다. `POST`: HTTP POST 요청을 보낸다.
모의 응답 (오프라인 / 대체) `mockResponse`	`textarea` 기본값: `{"status":"ok","source":"mock-api"}` 변수 참조 지원 (`$var`: `string`)	항상 노출	이 노드의 모의 응답 (오프라인 / 대체) 설정을 지정한다.

포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.

포트 성격: 고정 입력 포트 (총 2개).

포트 이름	포트 ID	데이터 타입	필수 여부	노출 조건	설명
`URL Override`	`url`	`String`	선택	항상 노출
`Request Body`	`body`	`Any`	선택	항상 노출

포트 성격: 고정 출력 포트 (총 2개).

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Response Bytes`	`data`	`Bytes`	항상 노출	응답 바이트 페이로드
`HTTP Status`	`status`	`Int`	항상 노출	상태 코드

이 노드는 런타임 실패 케이스가 없으며(errorProfile: none), 타입이 맞는 모든 입력에 대해 항상 성공한다.

외부 엔드포인트(또는 폴백 JSON)를 바이트로 받아 SHA-256 다이제스트를 계산한다.