호출 한도

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로 보내면 중복되지 않습니다.
네트워크 오류	위와 같습니다.