변경 기록

API와 웹훅에서 바뀐 점을 새것부터 적어요. 봇 코드를 고쳐야 하는 변경은 굵게 표시해요.

2026년 9월 15일#

• 봇마다 발급하던 API 토큰(hk_…)을 없애고 계정 단위 개발자 토큰(hkd_…)으로 바꿨어요. 예전 토큰은 더 쓸 수 없어요. 토큰에서 개발자 토큰을 만들어 바꿔 주세요. 인증
• heartbeat 주소가 POST /v1/bots/{id}/heartbeat로 바뀌었어요. 봇 id를 주소에 넣어 보내요. 예전 주소 POST /v1/bots/heartbeat는 410 Gone을 돌려줘요. 가동 상태
• 토큰 하나로 내가 소유했거나 '개발 도구' 권한을 받은 봇 모두에 쓸 수 있어요. 권한이 없는 봇에는 없는 봇과 똑같이 404를 돌려줘요.

2026년 9월 14일#

• 방 수 보고(POST /v1/bots/stats)와 첫 연결(POST /v1/bots/verify)을 없앴어요. 두 주소는 410 Gone을 돌려줘요. 연결과 가동 상태는 POST /v1/bots/heartbeat 하나로 보내요.
• 방 수를 봇이 보고하지 않고, 한카리 초대 신청으로 입장이 끝난 방을 한카리가 세요. 예전에 보고한 숫자는 입장 완료 기준으로 다시 셌어요. 자세히 보기
• 웹훅을 보내기 시작했어요. heart, invite.created, invite.accepted 이벤트와 서명, 다시 보내기 규칙이 있어요. 웹훅 설정
• 공개된 봇의 정보를 읽는 GET /v1/bots/{id}를 열었어요. 토큰 없이 쓸 수 있어요.