상태 코드와 그 이유

수정일 일요일, 9 3월 시간: 2:26 PM

Freshdesk에서는 다양한 상호작용 및 프로세스 중에 주의가 필요한 특정 문제나 이상을 나타내는 오류 코드가 나타날 수 있습니다. 이러한 오류 코드와 그 이유를 이해하면 근본적인 문제를 효율적으로 진단하고 해결하는 데 도움이 될 수 있습니다. 다음은 Freshdesk에서 발생하는 몇 가지 일반적인 오류 코드와 그 이유입니다.

HTTP 상태 코드	TEXT	설명
200	OK	요청이 성공했고 서버가 요청된 데이터로 응답했습니다.
201	창조됨	요청이 성공하여 새 리소스가 생성되었습니다.
204	콘텐츠 없음	요청에 성공했지만 응답에 보낼 콘텐츠가 없습니다.
400	클라이언트 또는 유효성 검사 오류	요청 본문/쿼리 문자열이 올바른 형식이 아닙니다. 예를 들어 티켓 만들기 API에서는 요청의 일부로 requester_id 필드를 보내야 하며 이 입력이 누락되면 이 상태 코드가 반환됩니다.
401	인증 실패	인증 헤더가 없거나 올바르지 않다는 것을 나타냅니다. 인증 헤더에 대한 자세한 내용은 here.
403	접속 거부	이 요청에 사용된 자격 증명을 가진 상담원에게 이 API 호출을 수행할 권한이 없음을 나타냅니다. 이 API 호출에 관리자 수준의 자격 증명이 필요하거나 Freshdesk 포털에 해당 기능이 활성화되어 있지 않을 수 있습니다. 또한 사용자가 최대 로그인 실패 횟수에 도달했거나 계정이 최대 상담원 수에 도달했음을 나타낼 수도 있습니다
404	요청한 리소스를 찾을 수 없음	이 상태 코드는 요청에 잘못된 ID/Freshdesk 도메인이 포함되어 있거나 URL 자체가 잘못된 경우 반환됩니다. 예를 들어 잘못된 ID를 가진 티켓을 검색하기 위한 API 호출은 그러한 티켓이 존재하지 않음을 알려주는 HTTP 404 상태 코드를 반환합니다.
405	방법이 허용되지 않음	이 API 요청은 잘못된 HTTP 동사/메서드를 사용했습니다. 예를 들어, /api/v2/tickets 엔드포인트에 대한 API PUT 요청은 GET 및 POST 요청만 허용하므로 HTTP 405를 반환합니다.
406	지원되지 않는 허용 헤더	만 application/json 및 */*만 지원됩니다. 파일 업로드 시 멀티파트/양식 데이터가 지원됩니다.
409	불일치/상충 상태	생성/업데이트 중인 리소스가 일관되지 않거나 충돌하는 상태입니다. 예를 들어 기존 사용자와 이미 연결된 이메일로 연락처 만들기를 시도하는 경우 이 코드가 반환됩니다.
415	지원되지 않는 콘텐츠 유형	콘텐츠 유형 application/xml은 지원되지 않습니다. application/json만 지원됩니다.
429	요금 한도 초과	Freshdesk 도메인에 할당된 API 요금 한도가 모두 소진되었습니다.
500	예기치 않은 서버 오류	휴!!! 여기서 더 이상 할 수 있는 작업이 없습니다. Freshdesk 측에서 오류가 발생했습니다. 응답 헤더와 함께 API 스크립트를 이메일로 보내주세요. 최대한 빨리 연락을 드리고 문제를 해결해 드리겠습니다.
502	Bad Gateway	서버가 게이트웨이 또는 프록시 역할을 하는 동안 업스트림 서버로부터 잘못된 응답을 수신했습니다.
503	서비스를 사용할 수 없음	점검 또는 과부하로 인해 서버가 요청을 처리할 준비가 되지 않았습니다.
504	게이트웨이 시간 초과	서버가 게이트웨이 또는 프록시 역할을 하는 동안 업스트림 서버로부터 적시에 응답을 받지 못했습니다.