> ## 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로 매니저의 티 매물을 등록하고 관리합니다.

조인성공 파트너 API는 외부 프로그램이 **매니저 본인의 권한으로** 조인성공에 티 매물을 올리고, 고치고, 마감할 수 있게 해 주는 API입니다. 매니저 PC에 설치되는 프로그램을 기준으로 설명합니다. 웹 서비스로 연동할 때도 흐름은 같고, 돌아올 주소만 다릅니다.

프로그램은 매니저의 아이디나 비밀번호를 받지 않습니다. 매니저가 브라우저에서 조인성공에 직접 로그인하고 연결을 허용하면, 프로그램은 그 매니저 전용 토큰을 받아 API를 호출합니다.

## 할 수 있는 일

| 기능 | 설명 |
| - | - |
| 조인성공으로 로그인 | OAuth 2.0 인가 코드 + PKCE로 매니저 토큰을 받습니다. |
| 티 매물 등록 | 조인·양도 티를 올립니다. 외부 고유 번호(`externalId`)로 중복 등록을 막을 수 있습니다. |
| 티 매물 수정·마감 | 바꿀 항목만 보내 고치고, 모집이 끝나면 마감합니다. |
| 끌어올리기 | 매물을 목록 맨 위로 올립니다. |
| 내 매물 조회 | 매니저가 올린 매물 전체와 단건을 조회합니다. |
| 월 사용량 조회 | 이번 달 게시 횟수와 플랜 한도를 확인합니다. |
| 골프장·코스 조회 | 등록에 필요한 골프장 ID와 코스 이름을 받습니다. |

## 기본 정보

| 항목 | 값 |
| - | - |
| Base URL | `https://golfjoin.co.kr` |
| 데이터 형식 | 요청과 응답 모두 JSON입니다. 토큰 발급 API는 `application/x-www-form-urlencoded` 형식으로 보내도 됩니다. |
| 인증 | `Authorization: Bearer {access_token}` |
| 문자 인코딩 | UTF-8 |
| 시간대 | 날짜와 티업 시간은 모두 한국 시간(KST)입니다. |
| 금액 | 원 단위 정수입니다. 15만원은 `150000`입니다. |

## 이용 순서

1. 조인성공에 [연동을 신청](#문의)해 클라이언트 ID를 받습니다.
2. 매니저가 [조인성공으로 로그인](https://docs.golfjoin.co.kr/api-introduction/authentication.md)해 토큰을 받습니다.
3. [골프장 목록](https://docs.golfjoin.co.kr/api-introduction/golf-courses.md)에서 골프장 ID와 코스 이름을 찾습니다.
4. [티 매물](https://docs.golfjoin.co.kr/api-introduction/tee-times.md)을 등록하고, 바뀌면 수정하고, 끝나면 마감합니다.

처음이라면 [빠른 시작](https://docs.golfjoin.co.kr/api-introduction/quickstart.md)부터 따라 해 보세요.

## 매니저 조건

API는 조인성공에서 **승인된 매니저**이면서 **플랜을 이용 중인** 계정만 쓸 수 있습니다. 매니저 가입은 [매니저 가입 신청](https://console.golfjoin.co.kr/manager/signup)에서 받고, 승인은 조인성공 운영팀이 합니다.

매니저 승인이 해제되거나 플랜이 끝나면 이미 받은 토큰도 그 즉시 `403 forbidden`을 돌려줍니다. 토큰을 다시 받을 필요는 없고, 계정 상태가 돌아오면 다시 호출할 수 있습니다.

## 문의

연동 신청, API 관련 요청, 장애나 오류 문의는 [lud@golfjoin.co.kr](mailto:lud@golfjoin.co.kr)와 [communication@golfjoin.co.kr](mailto:communication@golfjoin.co.kr) 두 곳으로 함께 메일을 보내 주세요.

| 메일 종류 | 함께 보낼 내용 |
| - | - |
| 연동 신청 | 회사·서비스 이름, 담당자 이름과 연락처, 공지를 받을 메일 주소, 프로그램 형태(설치형/웹), 웹 서비스라면 돌아올 주소(`https`) |
| 오류 문의 | 요청 시각, 호출한 주소와 메서드, 받은 상태 코드와 응답 본문, 매물 번호(있다면) |

토큰 값과 매니저 비밀번호는 메일에 넣지 마세요.


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