에러 코드

API가 돌려주는 오류 응답과 처리 방법입니다.

오류는 HTTP 상태 코드와 함께 아래 형식의 JSON으로 돌려줍니다.

{ "error": "invalid_input" }

error 값으로 원인을 구분하세요. 사람이 읽는 메시지는 담지 않으니, 매니저에게 보여 줄 문구는 프로그램에서 정해 주세요.

인증

HTTP	error	원인	처리
400	invalid_request	토큰 요청에 필수 파라미터가 없습니다.	요청을 고칩니다.
400	unsupported_grant_type	grant_type이 지원하지 않는 값입니다.	authorization_code 또는 refresh_token을 씁니다.
400	invalid_grant	인가 코드가 만료·재사용됐거나, redirect_uri·code_verifier가 맞지 않거나, refresh token이 만료·해제·재사용됐습니다.	다시 로그인합니다.
403	forbidden	토큰이 없거나 만료·무효입니다. 이 프로그램에 허용되지 않은 API이거나, 매니저 승인이 해제됐습니다.	토큰을 갱신합니다. 갱신 뒤에도 같으면 다시 로그인하거나 매니저 상태를 확인합니다.

티 매물

HTTP	error	원인	처리
400	invalid_input	필수 필드가 없거나 형식이 맞지 않습니다. courseLabel·title에 <, >가 들어간 경우도 포함합니다.	요청 값을 고칩니다.
400	no_target	끌어올리기에 대상 매물을 지정하지 않았습니다.	contentIds 또는 all을 보냅니다.
403	no_plan	플랜을 이용 중이 아닙니다.	매니저에게 플랜 확인을 안내합니다.
404	course_not_found	없는 골프장 ID입니다.	골프장 목록을 다시 받습니다.
404	not_found	없는 매물이거나 내 매물이 아닙니다.	매물 번호를 확인합니다.
429	post_quota_exceeded	이번 달 게시 한도를 다 썼습니다.	다음 달까지 기다리거나 플랜을 바꿉니다.

서버 오류와 점검

HTTP	응답	처리
500	JSON 또는 HTML	잠시 뒤 다시 보냅니다. 계속되면 [e-mail]와 [e-mail]로 알려 주세요.
502, 503, 504	HTML일 수 있습니다	배포나 점검 중입니다. 보통 1~2분 안에 돌아옵니다. 간격을 늘려 가며 다시 보냅니다.

5xx 응답은 본문이 JSON이 아닐 수 있습니다. 본문을 JSON으로 읽기 전에 상태 코드부터 확인하세요.

오류가 계속되거나 원인을 알 수 없으면 [e-mail]와 [e-mail]로 메일을 보내 주세요. 요청 시각, 호출한 주소, 받은 응답을 함께 적어 주시면 빠르게 확인할 수 있습니다.