봇 정보 조회

GET/v1/bots/{id}

공개된 봇의 이름, 방 수, 가동 상태, 하트를 읽어요. 봇 상세 화면에 보이는 값만 돌려줘서 토큰 없이 누구나 부를 수 있고, 다른 사이트의 브라우저에서도 바로 불러 쓸 수 있어요.

경로 변수#

이름	필수	설명
`id`	필수	봇 id. 신뢰된 봇이면 커스텀 URL로도 찾을 수 있어요.

curl "https://hankari.dev/v1/bots/bot_mf3k2x9a1b2c3d4e"

응답#

200 OK
{
  "id": "bot_mf3k2x9a1b2c3d4e",
  "name": "출첵봇",
  "summary": "출석 체크와 레벨을 관리해요",
  "avatarUrl": "https://hankari.dev/media/bots/u_mf2p8q1z/5c0f3a9b.png",
  "url": "https://hankari.dev/bots/bot_mf3k2x9a1b2c3d4e",
  "categories": ["출석·레벨", "방 관리"],
  "trusted": false,
  "status": "online",
  "rooms": 1204,
  "hearts": { "monthly": 128, "total": 3402 },
  "rank": 3
}

응답 필드#

필드	타입	설명
`id`	string	봇 id
`name`	string	봇 이름
`summary`	string \| null	한 줄 소개. 없으면 상세 소개의 첫 문단
`avatarUrl`	string \| null	프로필 사진 주소. 없으면 null
`url`	string	한카리의 봇 상세 주소
`categories`	string[]	카테고리 이름
`trusted`	boolean	신뢰된 봇 여부
`status`	string	online 또는 offline. 마지막 heartbeat 뒤 10분이 지나면 offline이에요.
`rooms`	number	한카리 초대 신청으로 들어가 입장 완료가 된 방 수
`hearts.monthly`	number	이번 달 하트. 매달 1일에 초기화돼요.
`hearts.total`	number	누적 하트
`rank`	number \| null	이번 달 하트 순위. 같으면 공동 순위예요.

오류#

봇이 없거나 아직 공개되지 않았으면 404와 { "error": "not_found" }를 돌려줘요.

방 수가 어떻게 세어지는지는 가동 상태 › 방 수는 어떻게 세나요에 있어요.