monday.com GraphQL API는 사전에 정의된 에러 리스트를 반환합니다. 만일GraphQL 어플리케이션에 의해  예외 처리가 된다면, 200 상태 코드가 반환되며 아래의 3가지 구조의 추가 정보가 반환됩니다.

{
  "errors": [
    {
      "message": "Field 'xxx' doesn't exist on type 'User'",
      "locations": [
        {
          "line": 322,
          "column": 5
        }
      ],
      "fields": [
        "query",
        "me",
        "xxx"
      ]
    }
  ],
  "account_id": 123456789
}

{
  "error_code": "SomeKindOfException", 
  "status_code": 200, 
  "error_message": "Some error happened", 
  "error_data": {...} 
}

{  
    "error_message": "Internal server error",
    "status_code": 500
}

아래 코드 샘플을 확인하여 다양한 오류 구조를 파악하는 방법을 확인하세요

function handleError(error) {
  if (error.hasOwnProperty('error_message') || error.hasOwnProperty('error_code') || error.hasOwnProperty('errors')) {
      throw 'error!';
    }
  }
  
  try {
    handleError(error);
  } catch (e) {
    console.error(e);
  }

Internal Server Error: 내부 서버 오류

HTTP 상태 code: 500

500에러는 쿼리 문자열 내의 일부 형식이 잘못되었음을 나타냅니다.

• 쿼리의 JSON 문자열 형식을 확인하십시오.
• create_item 혹은 hange_multiple_column_values 뮤테이션을 사용할 때 JSON 문자열 형식을 확인하십시오

Rate Limit Exceeded: 사용량 제한 초과

HTTP 상태 code: 429

429(사용량 제한 초과) 오류는 1분 동안 5,000개 이상의 요청을 수행했음을 나타냅니다.

1분 동안 5,000개 이상의 요청을 보내지 않도록 하십시오.

{
"error_message": "Rate Limit Exceeded.",
"status_code": 429
}

Your IP Is Restricted: IP 제한

HTTP 상태 code: 401

401(IP가 제한됨) 오류는 계정 관리자가 특정 IP 주소에서 시스템에 대한 접근을 제한했음을 나타냅니다.

IP 주소가 계정 관리자에 의해 제한되지 않는지 확인합니다.

{
"error_message": "Your ip is restricted.",
"status_code": 401
}

Unauthorized : 인증되지 않았을 시

HTTP 상태 code: 401

401(인증되지 않음) 에러는 접근하려는 데이터에 접근 권한이 없음을 나타냅니다.

API 키가 유효하고 "Authorization" 이 헤더에 전달되었는지 확인하십시오.

Bad Request : 잘못된 요청

HTTP 상태 code: 400

400 에러는 쿼리 문자열 구조가 잘못 전달되었음을 나타냅니다.

쿼리 문자열이 "query" 키와 함께 전달되고 요청이 JSON 본문을 사용하여 POST 요청으로 전송되며 쿼리에 종료되지 않은 문자열이 포함되어 있지 않은지 확인하십시오.

Parse error on...

HTTP 상태 code: 200

Parse error on… 에러는 쿼리의 문자열의 일부 형식이 잘 못되었음을 나타냅니다.

쿼리가 유효한 문자열이며 괄호, 대괄호 및 중괄호가 모두 닫혀 있는지 확인하세요.

ComplexityException: 복잡도 예외

HTTP 상태 code: 200

ComplexityException 와 함께 나타나는 200 에러는 복잡도 제한에 도달한 것을 나타냅니다.

중첩 쿼리 혹은 쿼리에 제한을 추가하여 제한에 도달하지 않도록 할 수 있습니다.

복잡도 제한에 대한 자세한 내용은 사용량 제한 문서를 참고해 주시기 바랍니다.

UserUnauthroizedException :  인증되지 않은 사용자 예외

HTTP 상태 code: 200

UserUnauthroizedException 와 함께 나타나는 200에러는 는 해당 사용자에게 해당 액션을 수행할 권한이 없음을 나타냅니다.

사용자에게 지정된 리소스에 액세스하거나 편집할 수 있는 권한이 있는지 확인하십시오.

InvalidUserIdException : 잘못된 사용자 ID 예외

HTTP 상태 code: 200

InvalidUserIdException 와 함께 나타나는 200에러는 쿼리에서 전달되는 사용자 ID가 유효한 사용자 ID가 아님을 나타냅니다.

사용자 ID가 존재하고 이 사용자가 보드에 할당되어 있는지 확인하십시오.

InvalidColumnIdException : 잘못된 컬럼 ID예외

HTTP 상태 code: 200

InvalidColumnIdException  와 함께 나타나는 200에러는 유효한 컬럼 ID가 아님을 나타냅니다.

컬럼  ID가 존재하고 컬럼에 액세스할 수 있는지 확인하십시오.

InvalidBoardIdException : 잘못된 보드 예외

HTTP 상태 code: 200

InvalidBoardIdException 와 함께 나타나는 200 에러 는 유효한 보드 ID가 아님은 나타냅니다.

보드 ID가 존재하고 보드에 액세스할 수 있는지 확인하십시오.

CreateBoardException : 보드 생성 예외

HTTP 상태 code: 200

CreateBoardException 와 함께 나타나는 200에러는 보드를 생성하기 위한 쿼리에 오류가 있음을 나타냅니다.

템플릿에서 보드를 작성하는 경우 템플릿 ID가 유효한 monday템플릿 또는 템플릿 상태를 가진 보드인지 확인하십시오. 보드 템플릿 만들기에 대한 자세한 내용은 여기를 참조하십시오.

보드를 복제하는 경우 보드 ID가 존재하는지 확인하십시오.

ResourceNotFoundException

HTTP 상태 code: 200

ResourceNotFoundException  와 함께 나타나는 200에러는 쿼리에서 전달하려는 ID가 유효하지 않음을 나타냅니다.

조회하는 항목, 그룹 또는 보드의 ID가 존재하는지 확인하십시오.

HTTP 상태 code: 404

ResourceNotFoundException 와 함께 나타난 404 에러는 쿼리에서 전달하려는 ID가 유효하지 않음을 나타냅니다.

조회하는 사용자의 ID가 존재하며 보드에 할당되어 있는지 확인하십시오.

ItemsLimitationException :

HTTP 상태 code: 200

ItemsLimitationException 과 함께 나타난 200 에러는 보드에 허용된 아이템 개수를 초과했음을 나타냅니다.

악용 방지를 위해 각 보드에는 API를 통해 작성된 아이템 수가 10,000개로 제한되어 있습니다.이 에러는, 제한에 이르렀을 때에 발생합니다.

ItemNameTooLongException

HTTP 상태 code: 200

ItemNameTooLongException과 함께 나타난 200 에러는 선택한 아이템의 이름이 허용된 문자 수를 초과했음을 나타냅니다.

아이템 이름의 길이가 1 ~255자인지 확인하십시오.

ColumnValueException

HTTP 상태 code: 200

ColumnValueException 과 함께 나타난 200에러는 쿼리에서 전송하려는 컬럼 값이 잘못된 형식임을 나타냅니다.

컬럼 값을 업데이트하는 경우, 값이 각 의 컬럼의 데이터 구조와 일치하는지 확인하세요.

JSON 값을 지원하는 컬럼에 대한 자세한 내용을 확인하고 싶다면 change_column_values()메소드 확인은 여기서 할 수 있습니다.

만일 컬럼 값을 검색하는 경우, 컬럼이 API에서 지원되고 고객 쪽에서 계산되지 않는지 확인하십시오(예: 함수 컬럼)

"The column has not connected boards" (컬럼에 연결된 보드가 없습니다)라는 오류가 표시되는 경우 참조하고 있는 Connect(연결) 컬럼이 monday.com UI를 통해 보드에 연결되어 있는지 확인합니다.

CorrectedValueException

HTTP 상태 code: 200

CorrectedValueException과 함께 나타난 200에러는 쿼리에서 전송하려는 값이 잘못된 유형임을 나타냅니다.

단순한 값(String값)으로 컬럼을 업데이트하려고 할 경우의 경우 컬럼이 이 유형의 값 형식을 지원하는지 확인합니다.

단순 값을 지원하는 컬럼에 대한 자세한 내용은change_simple_column_values() 메소드를 확인해 주세요.