Caravan Online 공개 API
도구 · 사이트 · 통계에 쓰는 읽기 전용 게임 자료입니다. 무료입니다.
키와 한도
- 설정 → 계정 → API 키에서 키를 3개까지 만듭니다. 키는 만들 때 한 번만 보이고, 폐기도 거기서 합니다.
- 모든 요청의 X-API-Key 머리글에 키를 넣습니다.
- 한 계정의 키는 한도 하나를 함께 씁니다: 1분에 60번, 한꺼번에 30번까지. 넘으면 429와 Retry-After(초)로 답합니다.
- 맞는 키가 없으면 401, API가 닫혀 있으면 503입니다.
주소
| 요청 | 항목 |
|---|---|
| GET /api/v1/version | api(형식 버전), build(클라이언트 빌드), server(서버 버전) |
| GET /api/v1/online | total(게임 안 플레이어 수); regions: region, players |
| GET /api/v1/guilds | guilds(상위 100): rank, name, tag, score, change7d, members |
| GET /api/v1/market | towns: town, items: item, tier, grade, currency, bestBuy, bestSell, buyQuantity, sellQuantity |
- 모든 답에 generated와 next가 있습니다: 이번 자료와 다음 자료의 유닉스 초.
- 서버는 5분마다 자료를 새로 씁니다. 답에는 Cache-Control max-age=300과 ETag가 붙고, If-None-Match를 보내면 304를 받습니다.
- bestBuy는 가장 높은 구매 주문, bestSell은 가장 낮은 판매 주문이며 없으면 null입니다. 값은 아이템 하나의 가격이고 그 화폐 단위이며, 금화는 100분의 1 단위로 셉니다.
- 어느 웹사이트든 브라우저에서 부를 수 있습니다(CORS, GET만).
- 플레이어 · 몬스터 · 자원의 실시간 위치는 내보내지 않습니다.
규칙
- 허용: 이 주소들을 읽는 도구 · 사이트 · 채팅 앱 봇 · 통계.
- 금지: 게임을 대신 하는 매크로나 프로그램, 게임의 복제나 사설 서버.
- 모든 사용에 이용약관이 적용됩니다. 어긴 키는 폐기합니다.