ApiCall 노드 에러

외부 API를 호출하는 ApiCall 노드에서 발생할 수 있는 에러입니다.

유효성 검사 에러

APICALL_MISSING_ENDPOINT

설명
API 엔드포인트가 지정되지 않았습니다. ApiCall 노드의 endpoint 속성이 null이거나 빈 값인 경우 발생합니다.

해결 방법
ApiCall 노드의 endpoint 속성에 호출할 API의 엔드포인트 경로를 지정해주세요.

APICALL_MISSING_URL

설명
API URL이 지정되지 않았습니다. ApiCall 노드의 url 속성이 누락된 경우 발생합니다.

해결 방법
ApiCall 노드의 url 속성에 올바른 API URL을 지정해주세요.

APICALL_MISSING_METHOD

설명
HTTP 메서드가 지정되지 않았습니다. ApiCall 노드의 method 속성이 null이거나 빈 값인 경우 발생합니다.

해결 방법
ApiCall 노드의 method 속성에 HTTP 메서드를 지정해주세요. 사용 가능한 메서드: GET, POST, PUT, DELETE, PATCH

APICALL_UNSUPPORTED_METHOD

설명
지원하지 않는 HTTP 메서드가 지정되었습니다. Carrier는 GET, POST, PUT, DELETE, PATCH 메서드만 지원합니다.

해결 방법
method 속성을 지원되는 HTTP 메서드 중 하나로 변경해주세요.

APICALL_INVALID_HTTP_METHOD

설명
허용되지 않은 HTTP 메서드가 지정되었습니다.

해결 방법
method 속성을 허용된 HTTP 메서드(GET, POST, PUT, DELETE, PATCH) 중 하나로 변경해주세요.

APICALL_INVALID_ENDPOINT_FORMAT

설명
엔드포인트 형식이 잘못되었습니다. URL 파싱에 실패한 경우 발생합니다.

해결 방법

엔드포인트 URL 형식이 올바른지 확인해주세요.

프로토콜(http/https)이 포함되어 있는지 확인해주세요.

특수 문자가 올바르게 인코딩되어 있는지 확인해주세요.

APICALL_INVALID_TIMEOUT_VALUE

설명
잘못된 타임아웃 값이 지정되었습니다. 타임아웃 값이 0 이하이거나 300초를 초과한 경우 발생합니다.

해결 방법
timeout 값을 1초에서 300초 사이의 값으로 설정해주세요.

APICALL_INVALID_RETRY_COUNT

설명
잘못된 재시도 횟수가 지정되었습니다. 재시도 횟수가 0 미만이거나 10을 초과한 경우 발생합니다.

해결 방법
retryCount 값을 0에서 10 사이의 값으로 설정해주세요.

APICALL_INVALID_HEADER_FORMAT

설명
헤더 형식이 잘못되었습니다. 헤더 파싱에 실패한 경우 발생합니다.

해결 방법

헤더가 올바른 키-값 형식인지 확인해주세요.

헤더 이름과 값에 유효하지 않은 문자가 포함되어 있지 않은지 확인해주세요.

APICALL_INVALID_BODY_FORMAT

설명
요청 본문(body) 형식이 잘못되었습니다. JSON 파싱에 실패한 경우 발생합니다.

해결 방법

요청 본문이 유효한 JSON 형식인지 확인해주세요.

JSON 구문 오류(누락된 쉼표, 따옴표 등)가 없는지 확인해주세요.

APICALL_INVALID_BODY_TYPE

설명
지원하지 않는 요청 본문 타입이 지정되었습니다.

해결 방법
body.type 속성을 지원되는 타입으로 변경해주세요.

APICALL_INVALID_QUERY_PARAM

설명
쿼리 파라미터 형식이 잘못되었습니다. 쿼리 파라미터 파싱에 실패한 경우 발생합니다.

해결 방법

쿼리 파라미터가 올바른 키-값 형식인지 확인해주세요.

특수 문자가 올바르게 인코딩되어 있는지 확인해주세요.

APICALL_MISSING_REQUIRED_HEADER

설명
필수 헤더가 누락되었습니다. Authorization 등 API 호출에 필수적인 헤더가 없는 경우 발생합니다.

해결 방법
API 명세를 확인하여 필수 헤더(예: Authorization, Content-Type 등)를 추가해주세요.

네트워크 에러

APICALL_CONNECTION_FAILED

설명
서버 연결에 실패했습니다. 대상 서버에 연결할 수 없는 경우 발생합니다.

해결 방법

대상 서버가 정상적으로 실행 중인지 확인해주세요.

URL이 올바른지 확인해주세요.

네트워크 연결 상태를 점검해주세요.

방화벽 또는 보안 그룹 설정을 확인해주세요.

APICALL_CONNECTION_TIMEOUT

설명
서버 연결 시간이 초과되었습니다. TCP 연결 수립에 실패한 경우 발생합니다.

해결 방법

대상 서버의 상태를 확인해주세요.

네트워크 지연 시간을 점검해주세요.

필요시 타임아웃 설정을 조정해주세요.

APICALL_READ_TIMEOUT

설명
응답 대기 시간이 초과되었습니다. 서버로부터 응답을 받는 데 너무 오래 걸린 경우 발생합니다.

해결 방법

대상 API의 처리 시간을 확인해주세요.

대용량 데이터를 처리하는 경우 페이징을 고려해주세요.

필요시 읽기 타임아웃 설정을 조정해주세요.

APICALL_WRITE_TIMEOUT

설명
요청 전송 시간이 초과되었습니다. 서버로 요청을 보내는 데 너무 오래 걸린 경우 발생합니다.

해결 방법

요청 본문의 크기를 확인해주세요.

네트워크 업로드 속도를 점검해주세요.

필요시 쓰기 타임아웃 설정을 조정해주세요.

APICALL_CONNECTION_REFUSED

설명
서버가 연결을 거부했습니다. 서버가 실행 중이지 않거나 포트가 닫혀 있는 경우 발생합니다.

해결 방법

대상 서버가 정상적으로 실행 중인지 확인해주세요.

URL과 포트가 올바른지 확인해주세요.

방화벽 설정을 확인해주세요.

APICALL_DNS_RESOLUTION_FAILED

설명
DNS 조회에 실패했습니다. 도메인 이름을 IP 주소로 변환할 수 없는 경우 발생합니다.

해결 방법

URL의 도메인 이름이 올바른지 확인해주세요.

도메인이 실제로 존재하는지 확인해주세요.

DNS 서버 설정을 점검해주세요.

APICALL_DNS_FAILURE

설명
DNS 조회에 실패했습니다. 도메인 해석에 실패한 경우 발생합니다.

해결 방법

URL의 도메인 이름이 올바른지 확인해주세요.

도메인이 실제로 존재하는지 확인해주세요.

DNS 서버 설정을 점검해주세요.

APICALL_SSL_HANDSHAKE_FAILED

설명
SSL 핸드셰이크에 실패했습니다. 인증서 문제로 보안 연결을 수립할 수 없는 경우 발생합니다.

해결 방법

대상 서버의 SSL 인증서가 유효한지 확인해주세요.

인증서가 만료되지 않았는지 확인해주세요.

인증서 체인이 올바르게 구성되어 있는지 확인해주세요.

APICALL_SSL_ERROR

설명
SSL/TLS 연결에 실패했습니다. TLS 또는 인증서 관련 오류가 발생한 경우입니다.

해결 방법

대상 서버의 SSL 인증서가 유효한지 확인해주세요.

인증서가 만료되지 않았는지 확인해주세요.

TLS 버전 호환성을 확인해주세요.

APICALL_NETWORK_UNREACHABLE

설명
네트워크에 접근할 수 없습니다. 네트워크 오류로 대상 서버에 도달할 수 없는 경우 발생합니다.

해결 방법

네트워크 연결 상태를 확인해주세요.

라우팅 설정을 점검해주세요.

VPN 연결이 필요한 경우 VPN 상태를 확인해주세요.

APICALL_TOO_MANY_REDIRECTS

설명
리다이렉트 횟수가 너무 많습니다. 10회를 초과하는 리다이렉트가 발생한 경우입니다.

해결 방법

최종 목적지 URL을 직접 사용해주세요.

리다이렉트 루프가 발생하지 않는지 확인해주세요.

API 제공자에게 문의해주세요.

APICALL_CIRCUIT_BREAKER_OPEN

설명
서킷 브레이커가 열려 있습니다. 연속적인 실패로 인해 일시적으로 요청이 차단된 상태입니다.

해결 방법

잠시 후 다시 시도해주세요.

대상 서버의 상태를 확인해주세요.

서킷 브레이커가 닫힐 때까지 대기해주세요.

HTTP 상태 에러

APICALL_HTTP_400

설명
잘못된 요청입니다 (400 Bad Request). 요청 형식이 올바르지 않거나 파라미터가 유효하지 않은 경우 발생합니다.

해결 방법

요청 파라미터가 API 명세와 일치하는지 확인해주세요.

필수 파라미터가 모두 포함되어 있는지 확인해주세요.

요청 본문의 형식이 올바른지 확인해주세요.

APICALL_HTTP_401 / APICALL_UNAUTHORIZED

설명
인증에 실패했습니다 (401 Unauthorized). API 키, 토큰 등 인증 정보가 유효하지 않은 경우 발생합니다.

해결 방법

인증 정보(API 키, Bearer 토큰 등)가 올바르게 설정되어 있는지 확인해주세요.

인증 정보가 만료되지 않았는지 확인해주세요.

헤더에 인증 정보가 올바른 형식으로 포함되어 있는지 확인해주세요.

APICALL_HTTP_403 / APICALL_FORBIDDEN

설명
접근이 거부되었습니다 (403 Forbidden). 인증은 되었지만 해당 리소스에 대한 권한이 없는 경우 발생합니다.

해결 방법

해당 API에 대한 접근 권한이 있는지 확인해주세요.

API 키의 권한 범위(scope)를 확인해주세요.

필요한 경우 API 제공자에게 권한을 요청해주세요.

APICALL_HTTP_404 / APICALL_NOT_FOUND

설명
리소스를 찾을 수 없습니다 (404 Not Found). 요청한 엔드포인트가 존재하지 않는 경우 발생합니다.

해결 방법

URL 경로가 올바른지 확인해주세요.

API 버전이 올바른지 확인해주세요.

요청하는 리소스 ID가 유효한지 확인해주세요.

APICALL_HTTP_408

설명
요청 시간이 초과되었습니다 (408 Request Timeout). 서버가 요청을 처리하는 데 너무 오래 걸린 경우 발생합니다.

해결 방법

잠시 후 다시 시도해주세요.

요청을 더 작은 단위로 분할하는 것을 고려해주세요.

APICALL_HTTP_429 / APICALL_RATE_LIMIT_EXCEEDED

설명
요청 횟수 한도를 초과했습니다 (429 Too Many Requests). API의 호출 제한(rate limit)을 초과한 경우 발생합니다.

해결 방법

잠시 후 다시 시도해주세요.

API 호출 빈도를 줄여주세요.

API 제공자의 rate limit 정책을 확인해주세요.

APICALL_HTTP_500

설명
서버 내부 오류입니다 (500 Internal Server Error). 대상 API 서버에서 예상치 못한 오류가 발생한 경우입니다.

해결 방법

잠시 후 다시 시도해주세요.

문제가 지속되면 API 제공자에게 문의해주세요.

APICALL_HTTP_502

설명
게이트웨이 오류입니다 (502 Bad Gateway). 프록시나 게이트웨이 서버가 업스트림 서버로부터 유효하지 않은 응답을 받은 경우 발생합니다.

해결 방법

잠시 후 다시 시도해주세요.

대상 서버의 상태를 확인해주세요.

APICALL_HTTP_503

설명
서비스를 사용할 수 없습니다 (503 Service Unavailable). 서버가 점검 중이거나 과부하 상태인 경우 발생합니다.

해결 방법

잠시 후 다시 시도해주세요.

서버 점검 일정을 확인해주세요.

APICALL_HTTP_504

설명
게이트웨이 시간 초과입니다 (504 Gateway Timeout). 프록시나 게이트웨이 서버가 업스트림 서버로부터 응답을 받지 못한 경우 발생합니다.

해결 방법

잠시 후 다시 시도해주세요.

대상 서버의 응답 시간을 확인해주세요.

APICALL_HTTP_4XX_ERROR / APICALL_HTTP_CLIENT_ERROR

설명
클라이언트 오류가 발생했습니다 (4xx). 위에 명시되지 않은 400~499 상태 코드에 해당합니다.

해결 방법

응답 상세 내용을 확인하여 구체적인 원인을 파악해주세요.

요청 형식과 파라미터를 점검해주세요.

APICALL_HTTP_5XX_ERROR / APICALL_HTTP_SERVER_ERROR

설명
서버 오류가 발생했습니다 (5xx). 위에 명시되지 않은 500~599 상태 코드에 해당합니다.

해결 방법

잠시 후 다시 시도해주세요.

문제가 지속되면 API 제공자에게 문의해주세요.

처리 에러

APICALL_JSON_PARSE_ERROR

설명
JSON 파싱에 실패했습니다. JSON 직렬화 또는 역직렬화 과정에서 오류가 발생한 경우입니다.

해결 방법

API 응답이 유효한 JSON 형식인지 확인해주세요.

Content-Type 헤더가 올바르게 설정되어 있는지 확인해주세요.

APICALL_RESPONSE_PARSING_FAILED / APICALL_RESPONSE_PARSE_ERROR

설명
응답 파싱에 실패했습니다. API 응답 본문을 처리하는 데 실패한 경우 발생합니다.

해결 방법

API 응답의 Content-Type과 인코딩을 확인해주세요.

응답 형식이 예상과 일치하는지 확인해주세요.

APICALL_PLACEHOLDER_ERROR

설명
플레이스홀더 변환에 실패했습니다. URL, 헤더, 또는 요청 본문에 포함된 플레이스홀더(예: {{변수명}})를 실제 값으로 변환하는 데 실패한 경우 발생합니다.

해결 방법

플레이스홀더에서 참조하는 변수명이 올바른지 확인해주세요.

해당 변수가 이전 노드에서 정상적으로 설정되었는지 확인해주세요.

변수의 경로(예: response.data.id)가 올바른지 확인해주세요.

APICALL_URL_ENCODING_ERROR

설명
URL 인코딩에 실패했습니다. URL에 인코딩할 수 없는 문자가 포함된 경우 발생합니다.

해결 방법

URL에 특수 문자가 올바르게 인코딩되어 있는지 확인해주세요.

쿼리 파라미터 값이 유효한지 확인해주세요.

APICALL_UNKNOWN_ERROR

설명
알 수 없는 API 호출 오류가 발생했습니다. 분류되지 않은 기타 에러입니다.

해결 방법

에러 상세 메시지를 확인하여 구체적인 원인을 파악해주세요.

문제가 지속되면 관리자에게 문의해주세요.

일반 에러

모든 노드에서 공통적으로 발생할 수 있는 일반적인 에러입니다.

EXECUTOR_UNKNOWN_ERROR

설명
알 수 없는 실행 오류가 발생했습니다. 모든 노드의 fallback 에러로, 분류되지 않은 예외 상황입니다.

해결 방법

에러 상세 메시지를 확인하여 구체적인 원인을 파악해주세요.

워크플로우 설정을 점검해주세요.

문제가 지속되면 관리자에게 문의해주세요.

ApiCall

ApiCall 노드 에러#

유효성 검사 에러#

APICALL_MISSING_ENDPOINT#

APICALL_MISSING_URL#

APICALL_MISSING_METHOD#

APICALL_UNSUPPORTED_METHOD#

APICALL_INVALID_HTTP_METHOD#

APICALL_INVALID_ENDPOINT_FORMAT#

APICALL_INVALID_TIMEOUT_VALUE#

APICALL_INVALID_RETRY_COUNT#

APICALL_INVALID_HEADER_FORMAT#

APICALL_INVALID_BODY_FORMAT#

APICALL_INVALID_BODY_TYPE#

APICALL_INVALID_QUERY_PARAM#

APICALL_MISSING_REQUIRED_HEADER#

네트워크 에러#

APICALL_CONNECTION_FAILED#

APICALL_CONNECTION_TIMEOUT#

APICALL_READ_TIMEOUT#

APICALL_WRITE_TIMEOUT#

APICALL_CONNECTION_REFUSED#

APICALL_DNS_RESOLUTION_FAILED#

APICALL_DNS_FAILURE#

APICALL_SSL_HANDSHAKE_FAILED#

APICALL_SSL_ERROR#

APICALL_NETWORK_UNREACHABLE#

APICALL_TOO_MANY_REDIRECTS#

APICALL_CIRCUIT_BREAKER_OPEN#

HTTP 상태 에러#

APICALL_HTTP_400#

APICALL_HTTP_401 / APICALL_UNAUTHORIZED#

APICALL_HTTP_403 / APICALL_FORBIDDEN#

APICALL_HTTP_404 / APICALL_NOT_FOUND#

APICALL_HTTP_408#

APICALL_HTTP_429 / APICALL_RATE_LIMIT_EXCEEDED#

APICALL_HTTP_500#

APICALL_HTTP_502#

APICALL_HTTP_503#

APICALL_HTTP_504#

APICALL_HTTP_4XX_ERROR / APICALL_HTTP_CLIENT_ERROR#

APICALL_HTTP_5XX_ERROR / APICALL_HTTP_SERVER_ERROR#

처리 에러#

APICALL_JSON_PARSE_ERROR#

APICALL_RESPONSE_PARSING_FAILED / APICALL_RESPONSE_PARSE_ERROR#

APICALL_PLACEHOLDER_ERROR#

APICALL_URL_ENCODING_ERROR#

APICALL_UNKNOWN_ERROR#

일반 에러#

EXECUTOR_UNKNOWN_ERROR#

ApiCall 노드 에러

유효성 검사 에러

APICALL_MISSING_ENDPOINT

APICALL_MISSING_URL

APICALL_MISSING_METHOD

APICALL_UNSUPPORTED_METHOD

APICALL_INVALID_HTTP_METHOD

APICALL_INVALID_ENDPOINT_FORMAT

APICALL_INVALID_TIMEOUT_VALUE

APICALL_INVALID_RETRY_COUNT

APICALL_INVALID_HEADER_FORMAT

APICALL_INVALID_BODY_FORMAT

APICALL_INVALID_BODY_TYPE

APICALL_INVALID_QUERY_PARAM

APICALL_MISSING_REQUIRED_HEADER

네트워크 에러

APICALL_CONNECTION_FAILED

APICALL_CONNECTION_TIMEOUT

APICALL_READ_TIMEOUT

APICALL_WRITE_TIMEOUT

APICALL_CONNECTION_REFUSED

APICALL_DNS_RESOLUTION_FAILED

APICALL_DNS_FAILURE

APICALL_SSL_HANDSHAKE_FAILED

APICALL_SSL_ERROR

APICALL_NETWORK_UNREACHABLE

APICALL_TOO_MANY_REDIRECTS

APICALL_CIRCUIT_BREAKER_OPEN

HTTP 상태 에러

APICALL_HTTP_400

APICALL_HTTP_401 / APICALL_UNAUTHORIZED

APICALL_HTTP_403 / APICALL_FORBIDDEN

APICALL_HTTP_404 / APICALL_NOT_FOUND

APICALL_HTTP_408

APICALL_HTTP_429 / APICALL_RATE_LIMIT_EXCEEDED

APICALL_HTTP_500

APICALL_HTTP_502

APICALL_HTTP_503

APICALL_HTTP_504

APICALL_HTTP_4XX_ERROR / APICALL_HTTP_CLIENT_ERROR

APICALL_HTTP_5XX_ERROR / APICALL_HTTP_SERVER_ERROR

처리 에러

APICALL_JSON_PARSE_ERROR

APICALL_RESPONSE_PARSING_FAILED / APICALL_RESPONSE_PARSE_ERROR

APICALL_PLACEHOLDER_ERROR

APICALL_URL_ENCODING_ERROR

APICALL_UNKNOWN_ERROR

일반 에러

EXECUTOR_UNKNOWN_ERROR