API 요청: API Request 컴포넌트 (AI Flowi Workflow)
API 요청을 수행하는 API Request는 URL 또는 cURL 명령으로 HTTP 요청을 보냅니다. 다른 시스템으로 보내는 외부 호출에 사용하며, JSON 응답은 이후 처리 단계에서 사용할 수 있습니다.
작성: Ai Flowi · 게시일
API Request는 카탈로그에 문서화되어 있습니다. Ai Flowi가 운영 환경에서 테스트한 기능은 아닙니다. 아래 예시는 설정 방법을 보여 주며, 실제 HTTP 요청은 전송하지 않았습니다.
입력
| 이름 | 유형 | 필수 여부 | 허용되는 입력 유형 | 설명 |
|---|---|---|---|---|
body | table | 아니요 | Data, JSON | 요청 본문 설정이며, Data 또는 JSON을 허용합니다. 콘텐츠 유형과 직렬화 규칙은 기록되어 있지 않습니다. |
curl_input | str | 아니요 | Message | cURL 명령 입력이며, Message를 허용합니다. 지원되는 cURL 옵션은 명시되지 않았습니다. |
follow_redirects | bool | 아니요 | 명시되지 않음 | 리디렉션을 따라갈지 설정하는 스위치입니다. 내보낸 자료에는 기본값과 리디렉션 횟수 제한이 없습니다. |
headers | table | 아니요 | Data, JSON | 요청 헤더이며, Data 또는 JSON을 허용합니다. 카탈로그에는 편집기의 테이블 형식이 정의되어 있지 않습니다. |
include_httpx_metadata | bool | 아니요 | 명시되지 않음 | HTTP 클라이언트 메타데이터 스위치입니다. 내보낸 자료에는 이 스위치가 추가하는 필드가 명시되어 있지 않습니다. |
method | str | 아니요 | 명시되지 않음 | GET, POST, PATCH, PUT, DELETE 중에서 선택합니다. 내보낸 자료에 나열된 메서드 선택지는 이 다섯 가지뿐입니다. |
mode | tab | 아니요 | 명시되지 않음 | URL 또는 cURL을 선택하여 요청 구성 모드를 지정합니다. |
query_params | other | 아니요 | Data, JSON | 쿼리 매개변수 설정이며, Data 또는 JSON을 허용합니다. 인코딩과 반복되는 매개변수의 처리 방식은 명시되지 않았습니다. |
save_to_file | bool | 아니요 | 명시되지 않음 | 파일 저장 스위치입니다. 경로, 보관 규칙, JSON 출력에 미치는 영향은 문서화되어 있지 않습니다. |
timeout | int | 아니요 | 명시되지 않음 | 요청 시간 제한 설정입니다. 카탈로그에는 단위, 범위, 기본값이 명시되어 있지 않습니다. |
url_input | str | 아니요 | Message | URL 모드의 대상 URL이며, Message를 허용합니다. |
명시된 선택지
method:GET,POST,PATCH,PUT,DELETE.mode:URL,cURL.
출력
| 표시 이름 | 이름 | 유형 | 연결 대상 |
|---|---|---|---|
| API Response | data | JSON | API Response는 JSON 유형으로 나열된 출력입니다. 내보낸 자료에는 응답을 감싸는 구조의 예시나 오류 응답 형식이 없습니다. |
API Request를 사용하는 경우
워크플로에서 HTTP 엔드포인트를 호출하려면 API Request를 사용합니다. 반환된 JSON을 처리하려면 API Request → JSON Operations 구성을, 다음 단계에 텍스트가 필요하면 API Request → Parser 구성을 권장합니다. 다음 단계에서 사용할 필드를 선택하기 전에 API Response를 확인하세요.
API Request를 사용하지 않는 경우
JSON 객체를 구성하려면 JSON Object Builder를, 로컬 값의 유형을 변경하려면 Type Convert를 사용합니다. 두 작업 모두 그 자체로는 HTTP 호출이 필요하지 않습니다. 라우팅 관련 내용은 HTTP Method Router를 참조하세요. 외부로 보내는 요청의 메서드를 선택하는 것은 이와 다른 구성 작업입니다.
관련 자료: API 게이트웨이: 진입점 라우팅, 정책과 백엔드 경계.
최소 구성
구성 예시이며, 실제 테스트 기록이 아닙니다
| 카탈로그 입력 이름 | 설정 예시 |
|---|---|
mode | URL |
method | GET |
url_input | https://example.com/ |
이 구성을 시도할 때는 호출 권한이 있는 대상을 사용하세요. 이 예시에는 헤더나 본문이 필요하지 않으며 인증 정보도 포함되어 있지 않습니다. 예시 도메인에서 특정 상태 코드나 JSON 응답을 반환한다고 단정하지 않습니다.
제한 사항
- 내보낸 자료의 모든 입력은 선택 사항으로 표시되어 있습니다. 이 표시가 대상 없이 요청을 실행할 수 있다는 근거는 아닙니다. 원본 자료에는 모드에 따른 유효성 검사가 설명되어 있지 않습니다.
- HEAD와 OPTIONS는 내보낸 자료의 메서드 선택지에 없습니다. 지원되는 cURL 플래그와 cURL 내용 및 별도의 URL 모드 필드 간 우선순위는 문서화되어 있지 않습니다.
- 응답을 감싸는 구조, JSON이 아닌 본문, HTTP 실패 처리, 재시도, 단위 시간당 요청 수 제한 시 동작, 시간 제한 단위, 파일 저장 세부 정보는 명시되지 않았습니다. 이 설정을 근거로 재시도나 워크플로 내 오류 분기를 보장하지 마세요.
- 리디렉션을 활성화하거나 요청 데이터를 연결하기 전에 대상, 헤더, 본문을 검토하여 의도한 서비스로 호출이 전달되도록 하세요. 외부 제공업체의 API 사용량은 워크플로 요금제에 포함되지 않습니다.
관련 컴포넌트
JSON Operations · JSON Object Builder · Parser · HTTP Method Router
노드 사용량
요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.
카탈로그 출처
API Request의 모드, 메서드, 필드 및 API Response 포트는 2026년 10월 9일에 내보낸 AI Flowi Workflow 1.9.2 카탈로그에 문서화되어 있습니다. 요청 실행 시 동작은 검증되지 않았습니다. 컴포넌트 카탈로그 보기.