다크 모드
HTTP 노드
HTTP 노드는 외부 API나 웹훅으로 요청을 보내고 응답 상태, 헤더, 본문을 다음 노드에 전달합니다.
언제 사용하나요?
- REST API에서 데이터를 조회하거나 변경할 때
- 워크플로우 실행 결과를 외부 웹훅으로 전달할 때
- 별도의 Tool 연동 없이 공개 HTTP API를 직접 호출할 때
입력
URL, 헤더 값, 쿼리 값, 요청 본문에는 고정값이나 현재 노드에서 접근할 수 있는 이전 노드의 출력 필드를 사용할 수 있습니다.
| 입력 위치 | 사용할 수 있는 값 |
|---|---|
| URL | 문자열 또는 문자열 타입의 이전 노드 출력 |
| 헤더 값 | 문자열·숫자 또는 같은 타입의 이전 노드 출력 |
| 쿼리 값 | 문자열·숫자 또는 같은 타입의 이전 노드 출력 |
| 본문 | 직접 작성한 텍스트 또는 이전 노드 출력 |
주요 설정
| 설정 | 설명 |
|---|---|
| Method | GET, POST, PUT, DELETE, PATCH, HEAD 중 하나를 선택합니다. 기본값은 GET입니다. |
| URL | 호출할 외부 http 또는 https 주소입니다. 반드시 설정해야 합니다. |
| Timeout | 연결과 응답을 기다릴 시간입니다. 기본값은 30,000ms이며 편집기에서 1,000–300,000ms로 설정할 수 있습니다. |
| Headers | 요청 헤더를 키와 값으로 추가합니다. 키는 비어 있을 수 없고 대소문자를 무시해 중복될 수 없습니다. |
| Query | URL에 추가할 쿼리 파라미터입니다. 각 키는 비어 있을 수 없습니다. |
| Body | POST, PUT, PATCH에서만 사용할 수 있습니다. 텍스트를 직접 입력하거나 이전 노드 출력을 선택합니다. |
인증 헤더
HTTP 노드에는 별도의 Auth 설정 화면이 없습니다. Bearer 토큰은 Authorization: Bearer ..., API 키는 서비스 사양에 맞는 헤더를 Headers 탭에 직접 추가하세요.
본문이 JSON이면 Content-Type을 따로 지정하지 않았을 때 application/json이 자동으로 설정됩니다. 그 외 본문에는 text/plain이 설정됩니다.
출력
응답은 response 객체로 제공됩니다.
| 출력 경로 | 타입 | 설명 |
|---|---|---|
response.status | number | HTTP 상태 코드입니다. |
response.statusText | string | HTTP 상태 설명입니다. |
response.ok | boolean | 상태 코드가 200 이상 300 미만이면 true입니다. |
response.headers | object | 응답 헤더입니다. 같은 이름의 값이 여러 개면 쉼표로 연결됩니다. |
response.body | string | 응답 본문 원문입니다. JSON 응답도 문자열로 제공됩니다. |
response.duration | number | 요청에 걸린 시간(ms)입니다. |
response.size | number | 서버가 콘텐츠 길이를 제공한 경우의 응답 크기입니다. |
4xx와 5xx 응답은 ok: false로 기록되고 노드 실행은 실패합니다. 연결, DNS, 타임아웃 오류도 실패로 처리됩니다.
연결과 배치 제약
- HTTP 노드는 일반 워크플로우뿐 아니라 Iteration과 Loop 안에도 배치할 수 있습니다.
- 설정에서 선택할 수 있는 변수는 현재 실행 순서와 같은 범위에서 접근 가능한 이전 노드 출력으로 제한됩니다.
- Loop나 Iteration 안에 배치한 HTTP 노드는 컨테이너 밖의 노드와 직접 연결할 수 없습니다.
예시
날씨 API를 호출하는 경우 다음과 같이 설정할 수 있습니다.
| 설정 | 값 |
|---|---|
| Method | GET |
| URL | https://api.open-meteo.com/v1/forecast |
Query latitude | 이전 노드의 위도 출력 |
Query longitude | 이전 노드의 경도 출력 |
Query current | temperature_2m |
다음 Code 노드에서 response.body를 JSON으로 파싱하거나, 원문 그대로 Output에 연결할 수 있습니다.
주의사항
localhost, 사설 IP, 링크 로컬 주소와.local,.internal호스트 등 내부 네트워크 대상은 보안 검증에서 차단됩니다.- JSON 응답은 자동으로 객체로 변환되지 않습니다. 개별 필드를 사용하려면 Code 노드에서 파싱하세요.
- 토큰이나 API 키를 URL 쿼리에 넣지 말고 서비스가 지원하는 인증 헤더를 사용하세요.
- 내보내기에서는 문자열
Authorization헤더가 마스킹되지만 다른 사용자 정의 인증 헤더까지 모두 마스킹되지는 않습니다. 공유 전 내보낸 파일을 확인하세요. - 응답 시간이 일정하지 않은 API에는 충분한 타임아웃을 설정하되 최대값은 300,000ms입니다.