> ## Documentation Index
> Fetch the complete documentation index at: https://docs.golfjoin.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 에러 코드

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

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

```json theme={null}
{ "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 | 잠시 뒤 다시 보냅니다. 계속되면 [lud@golfjoin.co.kr](mailto:lud@golfjoin.co.kr)와 [communication@golfjoin.co.kr](mailto:communication@golfjoin.co.kr)로 알려 주세요. |
| 502, 503, 504 | HTML일 수 있습니다 | 배포나 점검 중입니다. 보통 1\~2분 안에 돌아옵니다. 간격을 늘려 가며 다시 보냅니다. |

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.