Trip

TRIP / API V1

차분하고 유용한 여행 자동화를 만드세요

트립 도구·통합·AI 에이전트를 위한 명확한 소유자 범위 API입니다. 읽기 권한으로 시작하고 사용자가 계획을 승인한 뒤 쓰기 권한을 추가하세요.

OpenAPI 보기시작하기API 토큰 관리

인증

개인용 액세스 토큰은 한 번만 표시하며 Authorization 헤더로만 보냅니다. URL에 토큰을 넣지 마세요.

Authorization: Bearer trip_pat_…

작은 권한

작업에 필요한 최소 권한만 사용하세요. 모든 리소스는 토큰 소유자의 트립으로 제한됩니다.

trips:read · trips:write · token:inspect

에이전트에 맞는 계약

결정적인 JSON, 안정적인 오류 코드, 페이지네이션, 멱등 쓰기, OpenAPI 문서로 계획과 확인 단계를 예측 가능하게 만듭니다.

2분 만에 시작하기

설정에서 토큰을 만들고 서버 전용 secret store에 저장한 뒤 첫 트립 요청 전에 introspection 엔드포인트를 호출하세요.

curl https://trip.gumyo.net/api/v1/trips \
  -H 'Authorization: Bearer trip_pat_REDACTED'

안전한 기본값

먼저 읽으세요. 삭제나 전체 교체는 변경 내용을 요약하고 확인을 받으세요. 새 변경에는 새 멱등 키를, 재시도에는 같은 키를 사용하세요.

예측 가능한 한도

기본 토큰별 한도는 분당 읽기 60회·쓰기 20회입니다. rate-limit 헤더를 따르고 429 응답에서는 백오프하세요.