1. 에러 코드 가이드
Storm OpenAPI
  • Welcome to STORM
    • STORM 소개
  • Quickstart
    • 시작하기
      • 계정 생성
      • 에이전트 생성
    • 주요 활용 시나리오
      • 문서 업로드
      • 워크플로우 설계
      • 테스트
      • 배포
      • 채널 연동
  • Feature Guide
    • 콘솔
      • 에이전트 관리
      • 대시보드
      • 권한 설정
    • 에이전트 템플릿
      • 심층 지식 탐색
      • 지식 탐색
      • 자유 대화
      • 보고서 작성
      • FAQ 챗봇
      • 이력서 스크리닝
      • 캐릭터 대화
      • 상담기록 분석
      • 기사 작성
      • SQL문 작성
    • 에이전트 빌더
      • 지식
        • 문서
        • 폴더
        • 피드백
      • 워크플로우
        • 노드 설명
          • LLM
          • 검색(RAG)
          • 에이전틱 RAG
          • API
          • IF ELSE
          • 변수 선언과 할당
          • 후처리
          • 응답
          • 루프
          • 문서 생성
      • 테스트
      • 로그
      • 대시보드
    • 관리자 도구
      • 배포 관리
      • 채널 연동
      • 모델 파인튜닝
      • 학습 데이터 품질 관리
      • 기타 설정
      • Teams 채널 연동
  • Apis
    • 에이전트
      • 에이전트 조회
      • 에이전트 배포
      • 에이전트 배포 이력 조회
      • 워크플로우 목록 조회
      • 최신 워크플로우 조회
      • 워크플로우 단건 조회
      • 신규 워크플로우 생성
    • 버킷
      • 버킷 생성
      • 버킷 조회
    • 문서
      • 문서 학습 요청 by file
      • 문서 학습 요청 by url
      • 문서 조회
      • 문서 삭제
    • 채팅
      • 채팅 중 파일 업로드
        • 파일 생성 및 Presigned URL 발급
        • 파일 업로드 완료 처리
        • 파일 상태 조회
      • 채팅 전송 (OpenAI 호환)
      • 채팅 전송 (non-stream)
      • 채팅 전송 (stream)
      • 컨텍스트 검색
  • Learn More
    • 자주 묻는 질문
    • 과금 플랜
    • 에러 코드 가이드
      • AgentRag
      • DocGen
      • ApiCall
      • Function
      • IfElse
      • Loop
      • OpenLLM
      • Post
      • Rag
      • Response
      • Variable
  • Schemas
    • Response
      • CheckedException
    • [common] status
    • [object] document
    • [object] chat
    • [object] agent
    • [object] deployment
    • [object] chat stream chunk
    • [object] context
    • [object] user
    • [object] bucket
    • message
    • [res] pageinfo
  1. 에러 코드 가이드

ApiCall

유효성 검사 에러#

APICALL_MISSING_METHOD#

API 콜 노드에 HTTP 메소드(method)가 설정되지 않았습니다.
노드 설정에서 HTTP 메소드(method)를 GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS 중 하나로 선택해주세요.
API 콜 노드의 method 속성에 값을 입력했는지 확인해주세요.

APICALL_MISSING_URL#

API 콜 노드에 호출할 URL이 지정되지 않았습니다. 워크플로우 실행이 중단되었습니다.
API 콜 노드 설정에서 url 속성에 URL을 입력해주세요.
URL이 정확한 형식인지 확인해주세요.

APICALL_INVALID_URL_FORMAT#

API 콜 노드의 url 속성값이 올바른 형식이 아닙니다.
url 속성값이 http:// 또는 https:// 로 시작하는지 확인해주세요.
url 속성값에 공백이 포함되어 있지 않은지 확인해주세요.
워크플로우 빌더에서 url 속성값을 다시 입력해주세요.

APICALL_INVALID_HTTP_METHOD#

API 콜 노드에서 지원하지 않는 HTTP 메소드를 사용했습니다.
method 속성에 GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS 중 하나를 입력해주세요.
API 콜 노드 설정을 확인하여 올바른 HTTP 메소드를 선택해주세요.

APICALL_INVALID_BODY_TYPE#

API 콜 노드에서 지원하지 않는 body_type을 설정했습니다. 워크플로우 실행에 실패했습니다.
body_type 속성 값을 json, form, text, none 중 하나로 변경해주세요.
API에서 요구하는 body_type을 확인해주세요.

네트워크 에러#

APICALL_CONNECTION_FAILED#

API 호출 노드에서 서버 연결에 실패했습니다. url이 정확한지, 네트워크 연결이 올바른지 확인이 필요합니다.
노드 설정에서 url이 올바르게 입력되었는지 확인해주세요.
네트워크 연결 상태를 확인해주세요.
API 서버가 정상적으로 작동하는지 확인해주세요.

APICALL_CONNECTION_TIMEOUT#

API 호출 시간이 초과되어 API 콜 노드가 실패했습니다.
API 콜 노드의 url이 올바른지 확인해주세요.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 콜 노드의 타임아웃 설정을 늘려주세요.

APICALL_READ_TIMEOUT#

API 호출이 시간 초과로 실패했습니다. 서버가 연결을 수락했지만 응답이 너무 오래 걸렸습니다.
API 호출 노드의 timeout 값을 늘려주세요.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 서버의 응답 시간을 줄이도록 API 호출 방식을 변경해주세요.

APICALL_WRITE_TIMEOUT#

API 호출 시간이 초과되어 요청을 완료하지 못했습니다.
API 호출 노드의 타임아웃 설정을 확인하고 필요에 따라 늘려주세요.
API 서버가 정상적으로 작동하는지 확인해주세요.
네트워크 연결 상태를 확인해주세요.

APICALL_DNS_FAILURE#

API 호출 중 DNS 이름 확인에 실패했습니다. url에 입력된 호스트 이름이 정확하고 접근 가능한지 확인해주세요.
url 속성에 올바른 호스트 이름을 입력했는지 확인해주세요.
호스트 이름이 네트워크를 통해 접근 가능한지 확인해주세요.
워크플로우 빌더에서 API Call 노드의 url 설정을 다시 확인해주세요.

APICALL_SSL_ERROR#

API 호출 중 SSL/TLS 보안 연결에 실패했습니다. 서버 인증서에 문제가 있을 수 있습니다.
API 호출 대상 서버의 SSL 인증서가 유효한지 확인해주세요.
API 호출 노드의 url 속성이 올바른지 확인해주세요.
워크플로우 빌더에서 API 호출 노드의 설정을 다시 확인하고 워크플로우를 재실행해주세요.

HTTP 상태 에러#

APICALL_HTTP_400#

API 호출 노드에서 잘못된 요청(400)이 발생했습니다. 서버가 요청을 거부했습니다.
url 속성이 올바른지 확인해주세요.
요청 본문 또는 쿼리 파라미터가 서버의 요구사항을 충족하는지 확인해주세요.
API 제공 업체의 문서를 참조하여 요청 형식을 확인해주세요.

APICALL_HTTP_401#

API 호출에 실패했습니다. 인증이 필요한 API이며, 인증 정보가 올바르지 않습니다.
API 호출 노드 설정에서 API 키 또는 인증 헤더가 정확한지 확인해주세요.
API 제공 업체에 유효한 API 키를 요청해주세요.
API 문서에서 필요한 인증 방법을 확인하고, 워크플로우에 적용해주세요.

APICALL_HTTP_403#

API 호출에 실패했습니다. 접근 권한이 없어 API를 사용할 수 없습니다.
API 제공자에게 필요한 권한을 요청해주세요.
API 키 또는 인증 정보가 정확한지 확인해주세요.
API 호출 노드의 url이 올바른지 확인해주세요.

APICALL_HTTP_404#

API 호출에 실패했습니다. 서버에서 해당 URL을 찾을 수 없다는 응답을 보냈습니다.
API 콜 노드의 url 속성이 정확한지 확인해주세요.
URL 경로에 오타가 없는지 다시 한번 확인해주세요.
호출하려는 API가 해당 경로에서 작동하는지 확인해주세요.

APICALL_HTTP_408#

API 호출 시간이 초과되어 실패했습니다. 서버가 요청을 완료하기 전에 연결을 종료했습니다.
API 호출 노드의 url이 유효한지 확인해주세요.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 호출 노드의 타임아웃 설정을 늘려주세요.

APICALL_HTTP_429#

API 호출 횟수가 제한을 초과했습니다. 짧은 시간에 너무 많은 요청이 전송되었습니다.
API 호출 간 간격을 늘려주세요.
워크플로우 실행 빈도를 줄여주세요.
API 제공 업체의 사용량 제한을 확인하고 필요한 경우 사용량 제한을 늘려주세요.
API 호출 노드의 재시도 로직을 구현하여 일시적인 오류를 처리해주세요.

APICALL_HTTP_500#

API 호출 중 서버에서 예기치 않은 오류가 발생했습니다.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 제공업체에 문의하여 서버 상태를 확인해주세요.
API 호출 노드의 url이 정확한지 확인해주세요.

APICALL_HTTP_502#

API 호출 중 서버가 일시적으로 응답하지 않아 실패했습니다.
잠시 후 워크플로우를 다시 실행해주세요.
API 제공 업체의 서비스 상태를 확인해주세요.
API 호출 노드의 url이 올바른지 확인해주세요.

APICALL_HTTP_503#

API 호출에 실패했습니다. 대상 서비스가 일시적으로 응답하지 않습니다.
잠시 후 워크플로우를 다시 실행해주세요.
대상 서비스가 정상적으로 작동하는지 확인해주세요.
API 제공업체에 문의하여 서비스 상태를 확인해주세요.

APICALL_HTTP_504#

API 호출이 실패했습니다. 서버가 응답하는 데 너무 오래 걸렸습니다.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 호출 노드의 url이 정확한지 확인해주세요.
API 호출 노드의 타임아웃 설정을 늘려주세요.
API 서버에 문의하여 응답 시간 지연의 원인을 확인해주세요.

APICALL_HTTP_CLIENT_ERROR#

API 호출 노드에서 클라이언트 에러(4xx)가 발생했습니다. 요청 URL, 헤더, 본문을 확인해주세요.
url 속성이 올바른지 확인해주세요.
요청 헤더가 정확하게 설정되었는지 확인해주세요.
요청 본문이 API의 요구사항을 충족하는지 확인해주세요.
API 제공업체에 문의하여 문제 해결을 시도해주세요.

APICALL_HTTP_SERVER_ERROR#

API 호출 중 서버에서 예기치 않은 오류가 발생했습니다. 대상 서비스가 일시적으로 응답하지 않을 수 있습니다.
잠시 후 워크플로우를 다시 실행해주세요.
API 제공 서비스가 정상적으로 작동하는지 확인해주세요.
API 호출 노드의 url 설정이 정확한지 확인해주세요.

처리 에러#

APICALL_JSON_PARSE_ERROR#

API 응답 형식이 JSON이 아니어서 API 호출에 실패했습니다.
API 서버가 JSON 형식으로 응답하는지 확인해주세요.
API 호출 노드의 url이 올바른지 확인해주세요.
다른 API 엔드포인트를 사용하거나, API 제공업체에 문의해주세요.

APICALL_RESPONSE_PARSE_ERROR#

API 응답 형식이 예상과 달라 데이터를 처리할 수 없습니다.
API 응답 형식이 올바른지 확인해주세요.
API 제공자에게 문의하여 응답 형식을 확인해주세요.
API 콜 노드의 설정에서 응답 데이터 처리 방식을 조정해주세요.

APICALL_PLACEHOLDER_ERROR#

API 호출에 필요한 값이 올바르게 입력되지 않았습니다. 참조된 노드 ID나 필드 이름이 존재하지 않을 수 있습니다.
API 호출 노드 설정에서 참조하는 노드 ID와 필드 이름이 정확한지 확인해주세요.
참조하는 노드가 워크플로우에 존재하는지 확인해주세요.
필수 입력 필드가 누락되지 않았는지 확인해주세요.

APICALL_URL_ENCODING_ERROR#

API 호출 중 URL 인코딩에 실패했습니다. URL이나 쿼리 파라미터에 잘못된 문자가 있는지 확인해주세요.
API 콜 노드의 url 속성에 입력된 URL을 확인해주세요.
URL에 특수 문자나 공백이 포함되어 있다면 올바르게 인코딩해주세요.
쿼리 파라미터에 잘못된 문자가 있는지 확인하고 수정해주세요.

알 수 없는 에러#

APICALL_UNKNOWN_ERROR#

API 호출 노드에서 예상치 못한 오류가 발생했습니다. API 서버가 응답하지 않거나 노드 설정이 잘못되었을 수 있습니다.
API 서버가 정상적으로 작동하는지 확인해주세요.
API 호출 노드의 url이 정확한지 확인해주세요.
API 호출 노드의 다른 속성들이 올바르게 설정되었는지 확인해주세요.
Modified at 2026-05-27 10:30:57
Previous
DocGen
Next
Function
Built with