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`입니다.

이용 순서

조인성공에 연동을 신청해 클라이언트 ID를 받습니다.
매니저가 조인성공으로 로그인해 토큰을 받습니다.
골프장 목록에서 골프장 ID와 코스 이름을 찾습니다.
티 매물을 등록하고, 바뀌면 수정하고, 끝나면 마감합니다.

처음이라면 빠른 시작부터 따라 해 보세요.

매니저 조건

API는 조인성공에서 승인된 매니저이면서 플랜을 이용 중인 계정만 쓸 수 있습니다. 매니저 가입은 매니저 가입 신청에서 받고, 승인은 조인성공 운영팀이 합니다. 매니저 승인이 해제되거나 플랜이 끝나면 이미 받은 토큰도 그 즉시 403 forbidden을 돌려줍니다. 토큰을 다시 받을 필요는 없고, 계정 상태가 돌아오면 다시 호출할 수 있습니다.

문의

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

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

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