콘텐츠로 이동

HTTP POST

HTTP POST 스킬은 지정된 URL에 POST 요청을 실행합니다. JSON 또는 텍스트 본문을 전송할 수 있습니다.


설정 방법

1. 스킬 노드 추가 및 선택

스킬 노드를 추가하고 우측 패널에서 HTTP POST를 선택합니다.

HTTP POST 스킬 선택

2. 인증 연결 (선택)

API Key가 필요한 경우 인증 탭에서 API Key 인증 정보를 선택합니다.

3. 파라미터 입력

설정 탭에서 URL, 요청 본문, 헤더 등을 입력합니다.

HTTP POST 파라미터 입력 — url, body, headers 설정


파라미터

파라미터 필수 설명
url O 요청 URL
body 요청 본문 (JSON 객체 또는 텍스트)
params 쿼리 파라미터 (JSON 객체)
headers 커스텀 헤더 (JSON 객체)
timeout 타임아웃 초 (기본: 30)

인증 정보

API Key 인증 (선택). 설정 시 X-API-Key 헤더로 전달됩니다.


출력

{
  "success": true,
  "data": {
    "response": {
      "id": 123,
      "status": "created"
    },
    "status_code": 201,
    "headers": {
      "content-type": "application/json"
    }
  }
}

사용 예시

웹훅 데이터 외부 API로 전달

워크플로우 예시 — 웹훅 → AI 에이전트 → HTTP POST

파라미터
url https://api.example.com/orders
body {{ $('agent_1').data_content }}
headers {"Content-Type": "application/json"}

Slack 웹훅 알림

파라미터
url https://hooks.slack.com/services/T.../B.../xxx
body {"text": "{{ $('agent_1').text_content }}"}

참고

  • body가 객체(dict)이면 JSON으로 전송되고, 문자열이면 raw body로 전송됩니다.
  • JSON 응답은 자동 파싱됩니다.