# 조인성공 파트너 API

- [API 개요](https://docs.golfjoin.co.kr/api-introduction/overview.md): 조인성공 파트너 API로 매니저의 티 매물을 등록하고 관리합니다.
- [빠른 시작](https://docs.golfjoin.co.kr/api-introduction/quickstart.md): 로그인부터 티 매물 등록, 마감까지 한 번에 따라 해 봅니다.
- [인증](https://docs.golfjoin.co.kr/api-introduction/authentication.md): OAuth 2.0 인가 코드 + PKCE로 매니저 토큰을 받고 갱신합니다.
- [티 매물](https://docs.golfjoin.co.kr/api-introduction/tee-times.md): 조인·양도 티를 등록하고, 수정하고, 마감합니다.
- [골프장](https://docs.golfjoin.co.kr/api-introduction/golf-courses.md): 티 매물 등록에 필요한 골프장 ID와 코스 이름을 받습니다.
- [호출 한도](https://docs.golfjoin.co.kr/api-introduction/rate-limits.md): API 호출 간격과 월 게시 한도를 안내합니다.
- [에러 코드](https://docs.golfjoin.co.kr/api-introduction/error-codes.md): API가 돌려주는 오류 응답과 처리 방법입니다.
- [업데이트 노트](https://docs.golfjoin.co.kr/api-introduction/changelog.md): 파트너 API 변경 내역입니다.
- [토큰 발급·갱신](https://docs.golfjoin.co.kr/api-reference/auth/issue-token.md): 인가 코드로 처음 토큰을 받거나(`grant_type=authorization_code`), refresh token으로 새 토큰을 받습니다(`grant_type=refresh_token`). 갱신하면 access token과 refresh token이 모두 새로 발급되고, 이전 두 토큰은 바로 무효가 됩니다. 이미 쓴 refresh token이 다시 들어오면 그 매니저의 연결을 모두 끊습니다.
- [연결 해제(토큰 철회)](https://docs.golfjoin.co.kr/api-reference/auth/revoke-token.md): access token 또는 refresh token을 보내면 그 토큰 쌍을 무효로 합니다. 이미 무효인 토큰도 같은 응답을 돌려줍니다.
- [내 매물 목록](https://docs.golfjoin.co.kr/api-reference/tee-times/list-tee-times.md): 매니저가 직접 올린 매물 전체(마감 포함)와, 조인성공이 그 매니저 번호로 수집한 노출 중 매물을 최신 갱신순으로 돌려줍니다. 페이지를 나누지 않습니다.
- [티 매물 등록](https://docs.golfjoin.co.kr/api-reference/tee-times/create-tee-time.md): 티 매물을 등록하고 바로 노출합니다. 월 게시 한도를 1건 차감합니다. 같은 externalId로 이미 등록한 매물이 있으면 새로 만들지 않고 그 번호와 `duplicate: true`를 돌려줍니다(한도 차감 없음).
- [매물 단건 조회](https://docs.golfjoin.co.kr/api-reference/tee-times/retrieve-tee-time.md): 수정 화면에 필요한 전체 항목을 돌려줍니다.
- [티 매물 수정·마감](https://docs.golfjoin.co.kr/api-reference/tee-times/update-tee-time.md): 보낸 필드만 바꿉니다. 값을 지우려면 null로 보냅니다. 실제로 바뀐 값이 있으면 매물이 목록 위로 올라가고(한도 차감 없음), 바뀐 게 없으면 `updated: false`로 아무것도 하지 않습니다. `action: "close"`를 보내면 마감합니다. 마감한 매물은 다시 열 수 없습니다.
- [끌어올리기](https://docs.golfjoin.co.kr/api-reference/tee-times/bump-tee-times.md): 매물을 목록 맨 위로 올립니다. 매물 1건마다 월 게시 한도를 1건 차감합니다. 마감했거나 노출 중이 아닌 매물, 티업 시간이 지난 매물은 빠집니다. 남은 한도보다 대상이 많으면 오래된 매물부터 한도만큼만 올립니다. `all: true`만 보내면 노출 중인 매물 전부가 대상이니 보통 `olderThanDays`를 함께 보내세요.
- [월 사용량](https://docs.golfjoin.co.kr/api-reference/tee-times/retrieve-usage.md): 이번 달 게시 횟수와 플랜 한도를 돌려줍니다.
- [골프장 목록·검색](https://docs.golfjoin.co.kr/api-reference/golf-courses/list-golf-courses.md): `all=1`이면 전체 골프장과 코스 목록을 돌려줍니다(1시간 캐시). `q`를 주면 이름으로 검색해 최대 20건을 돌려줍니다(코스 목록 없음). 인증이 필요 없습니다.

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)


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