비밀값으로 표시됩니다.
토큰 형식
bti_ 뒤에 영문자 · 숫자 · _ · -로 된 43자가 붙습니다. 앱 로그인 토큰으로는 API를 호출할 수 없습니다. 연동 토큰으로는 이 API 외의 Bottari 기능을 호출할 수 없습니다.
토큰 관리하기
토큰은 팀 소유자만 볼 수 있습니다.설정 → API 연동에서 연동을 열면 비밀값이 있습니다.
보기·복사: 현재 토큰을 표시하거나 복사합니다. 여러 번 볼 수 있고, 볼 때마다 감사 기록에 남습니다.새로 만들기: 새 토큰을 만듭니다. 현재 토큰은 그 즉시 거절됩니다.
연동 지우기를 누르면 그 토큰의 요청을 바로 거절하고 연결도 모두 끊습니다. 지운 연동의 봇이 쓴 행에는 봇 ID가 그대로 남습니다.
연동 만들기 · 새 토큰 만들기 · 웹훅 구독 만들기는 합쳐서 팀마다 시간당 10번까지입니다. 연동은 팀마다 25개까지 만들 수 있습니다.
인증 오류
서버는 경로 · JSON · 인증 · 버전 · 본문 순서로 검사합니다. 없는 경로는 토큰을 확인하기 전에 400
invalid_request_url로 거절합니다.
연동 봇
연동마다 봇 사용자가 하나씩 있습니다.GET /v1/users/me의 id가 그 봇의 ID입니다.
- 연동이 만든 행의
created_by와 고친 행의last_edited_by에 이 ID가 들어갑니다. - 웹훅의
authors에도{ "id": "<봇 ID>", "type": "bot" }로 들어갑니다. 자신이 쓴 변경을 거를 때 사용하세요. - 연동을 만든 사람이나 데이터베이스를 연결한 사람이 팀을 떠나도 연동은 남습니다.
토큰 안전하게 사용하기
- 토큰은 서버의 환경 변수나 비밀값 저장소에 두세요.
- 작업마다 연동을 따로 만들고, 필요한 권한과 데이터베이스만 지정하세요.
- 토큰이 유출되면
새로 만들기를 눌러 이전 토큰을 바로 막으세요.