> ## 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 호출 간격과 월 게시 한도를 안내합니다.

## 호출 간격

지금은 파트너 API에 초당·분당 호출 제한을 걸지 않았습니다. 다만 매니저 한 명당 아래 간격을 지켜 주세요. 이후 제한을 두게 되면 적용 전에 미리 알려 드립니다.

| 호출 | 권장 간격 |
| - | - |
| 등록·수정·마감 | 초당 2회 이하 |
| 내 매물 목록 | 1분에 1회 이하 |
| 골프장 전체 목록 | 하루 1회 |
| 토큰 갱신 | access token이 만료되기 전 한 번 |

여러 매물을 한꺼번에 올릴 때도 한 건씩 차례로 보내 주세요.

## 월 게시 한도

매니저 플랜마다 한 달에 올릴 수 있는 게시 수가 정해져 있습니다.

* 등록 1건, 끌어올리기 1건이 각각 1회로 계산됩니다. 조인성공 화면에서 한 끌어올리기도 같은 한도에서 빠집니다.
* 수정, 마감, `externalId` 중복으로 돌아온 등록은 계산하지 않습니다.
* 한도는 매월 1일 0시(한국 시간)에 다시 채워집니다.
* 남은 횟수는 `GET /api/v1/manager/usage`로 확인합니다. `posts.limit`이 `-1`이면 무제한입니다.

한도를 넘기면 등록이 `429 post_quota_exceeded`로 실패하고, 응답의 `usage`에 현재 사용량이 담겨 옵니다.

## 재시도

| 응답 | 처리 |
| - | - |
| `429 post_quota_exceeded` | 다시 보내도 같습니다. 매니저에게 한도 초과를 알려 주세요. |
| `500`, `502`, `503`, `504` | 잠시 뒤 다시 보냅니다. 1초, 2초, 4초처럼 간격을 늘리고, 등록은 같은 `externalId`로 보내면 중복되지 않습니다. |
| 네트워크 오류 | 위와 같습니다. |


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