개발자 API
TourPro 개발자 API를 사용하면 자체 스크립트나 외부 연동 서비스에서 내 TourPro 데이터를 읽어올 수 있습니다. 접근 인증은 개인용 액세스 토큰(Personal Access Token)을 통해 이루어지며, 각 토큰은 생성한 사용자 권한으로 동작하여 본인이 볼 수 있는 투어만 조회할 수 있습니다.
1단계(Phase 1)는 읽기 전용입니다: 내 계정 정보, 참여 중인 투어 목록, 일정 이벤트를 가져올 수 있습니다.
토큰 만들기
프로필 열기
웹 앱에서 **프로필(Profile)**을 열고 개발자(Developer) 탭을 선택합니다.
토큰 생성
**토큰 만들기(Create token)**를 클릭하고 용도를 알아볼 수 있는 이름(예: 토큰을 사용할 스크립트나 서비스 이름)을 입력한 뒤 확인합니다.
즉시 복사하여 보관
보안을 위해 토큰 값은 생성 직후 단 한 번만 표시됩니다. 지금 바로 복사하여 비밀번호처럼 안전하게 보관하세요. 분실한 경우 기존 토큰을 폐기하고 새로 발급받아야 합니다.
API 호출하기
요청 헤더에 Bearer 인증 자격 증명으로 토큰을 담아 전송합니다:
Authorization: Bearer tourpro_...| 엔드포인트 | 반환 데이터 |
|---|---|
GET /api/v1/me | 내 사용자 ID, 이름 및 이메일 |
GET /api/v1/tours | 내가 접근할 수 있는 투어 목록 |
GET /api/v1/tours/:tourId/events | 내 권한 및 공개 범위에 따라 필터링된 특정 투어의 일정 이벤트 |
기본 URL은 웹 앱 주소가 아닌 API 호스트(예: https://api.tourpro.app)입니다.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."API는 토큰당 분당 120회 요청으로 속도 제한(Rate Limit)이 적용됩니다. 한도를 초과하면 제한 시간 창 정보를 담은 RateLimit 헤더와 함께 429 응답이 반환됩니다.
토큰 폐기하기
다시 개발자(Developer) 탭으로 돌아가 해당 토큰 옆의 **폐기(Revoke)**를 클릭하고 확인합니다. 폐기는 즉시 영구적으로 적용되며, 대체 토큰이 필요하면 새 토큰을 생성하세요.
토큰이 조회할 수 있는 데이터 범위
토큰은 발급자 본인이 볼 수 있는 범위를 절대 넘어설 수 없습니다:
- 투어: 본인이 생성했거나 멤버로 소속된 투어만 조회됩니다.
- 이벤트: 일정 보기 권한이 있는 경우에만 조회되며, 해당 투어에서 내 역할과 날짜에 공개된 이벤트만 반환됩니다.
- 모든 작업은 읽기 전용입니다. API를 통해서는 어떤 데이터도 수정하거나 삭제할 수 없습니다.
앱의 웹 세션 로그인 정보는 API에서 작동하지 않습니다. v1 엔드포인트는 오직 tourpro_ 접두사가 붙은 토큰만 허용하므로, 탈취된 브라우저 세션을 API에 재사용할 수 없습니다.