API Loader

외부 API에서 데이터를 불러와 문서 형식(Document)으로 변환하는 로더 노드입니다. RESTful API를 활용해 다양한 JSON 데이터를 수집하고, 이후 텍스트 분할기와 함께 문서 파이프라인에 사용할 수 있습니다. 내부 문서화되지 않은 API도 자유롭게 호출할 수 있어 확장성이 뛰어납니다.

---

주요 기능

• GET 또는 POST 방식으로 외부 API 호출 가능

• 응답 데이터를 Document 형식으로 변환

• Headers, Body, Metadata 등 세부 요청 구성 가능

• 응답 데이터 중 제외할 Metadata key를 지정해 정제된 문서 생성

• Text Splitter와 함께 사용 시 장문 응답 처리 용이

WindyFlo API Loader

WindyFlo API Loader Parameters

입력값 (Inputs)

항목	설명	필수 여부
Text Splitter	긴 텍스트 분할을 위한 노드 연결	선택
Method	API 호출 방식 (GET 또는 POST)	필수
URL	API 엔드포인트 URL	필수

---

파라미터 (Parameters)

항목	설명
Headers	요청 시 포함할 HTTP 헤더 항목들 (예: Authorization)
Body	POST 방식 사용 시 전달할 데이터 객체
Additional Metadata	문서에 함께 포함할 추가 메타데이터 항목
Omit Metadata Keys	응답 데이터 중 제외할 metadata 키 지정 (쉼표로 구분된 키 목록, 예: key1, key2.nestedKey)

---

출력값 (Outputs)

출력 항목	설명
Document	pageContent와 metadata를 포함한 Document 객체 배열
Text	모든 문서를 하나의 텍스트로 연결한 문자열 (선택 출력 형식)

---

활용 예시

• Step 1. 사내 API 또는 외부 API로부터 JSON 데이터 수집

• Step 2. Headers와 Body 값을 설정하여 인증된 POST 요청 실행

• Step 3. 문서로 변환된 응답을 벡터 스토어에 저장하거나 QA 파이프라인에 활용

• 고객 리뷰 API, 기술문서 API, 뉴스 API 등을 문서로 처리 가능

• Custom Metadata 삽입으로 후속 검색/필터링 최적화

• URL만 바꿔도 다양한 API 연동 가능하여 반복 활용도 높음

---

사용 팁

• Text Splitter를 함께 사용하면 API 응답이 장문일 경우에도 적절히 분할 가능

• 응답 구조가 복잡할 경우 Omit Metadata Keys를 활용하여 불필요한 필드 정리

• API 키가 필요한 경우 Headers에 Authorization 키 삽입 필요

---

주의사항

• Method와 URL은 반드시 입력되어야 하며, 누락 시 실행되지 않음

• API 응답 형식이 문서 처리에 적합하지 않다면 후속 파싱이 필요

• 과도한 데이터 호출은 속도 저하 및 API 요금 과금 위험 존재

• Text Splitter 미연결 시 긴 텍스트가 잘리지 않고 그대로 전달됨