구독 만들기
1
받을 서버 준비하기
주소로 온 POST에 2xx로 응답하고 본문의
verification_token을 확인할 수 있게 하세요.2
구독 만들기
연동 상세의
연결된 데이터베이스 아래 웹훅에서 구독 만들기를 누르고 받을 주소와 받을 이벤트를 지정하세요.이벤트는 처음에 모두 선택되어 있습니다. API 버전은
2026-03-11로 고정됩니다. comment.* 이벤트를 받으려면 권한에서 댓글 읽기도 켜세요.3
인증 토큰 받기
Bottari가 그 주소로 POST를 보내면 본문에서 인증 토큰을 확인하세요.
서버가 2xx가 아닌 코드로 응답해도 토큰을 받았다면 인증할 수 있습니다.
4
토큰 넣기
인증을 누르고 받은 토큰을 넣으세요.상태가
켜짐 · API 버전 2026-03-11로 바뀌면 그 뒤의 변경부터 이벤트를 전송합니다. 인증 전의 변경은 전송하지 않습니다.5
토큰 보관하기
인증 토큰을 서버의 환경 변수에 넣으세요.
인증 전에 할 수 있는 작업
토큰 다시 보내기: 같은 토큰을 다시 보냅니다. 구독마다 시간당 10번까지입니다.- 주소 바꾸기: 새 토큰을 만들어 새 주소로 보냅니다. 이전 토큰은 사용할 수 없습니다.
토큰이 맞지 않아요.가 표시됩니다.
인증 뒤에 할 수 있는 작업
고치기: 받을 이벤트를 언제든 고칠 수 있습니다.- 주소 바꾸기: 잠겨 있어 바꿀 수 없습니다. 구독을 지우고 새로 만드세요.
일시 중지·다시 시작: 멈춘 동안의 변경은 다시 시작해도 전송하지 않습니다. 전송을 기다리던 이벤트도 지웁니다.구독 지우기: 같은 주소도 처음부터 다시 인증해야 합니다.
전송 실패에서 실패 횟수와 마지막 시각을 확인할 수 있습니다. 재시도와 자동 정지 자세히 알아보기 →
받을 주소 규칙
https만 받습니다.- 2,048자까지 사용할 수 있습니다.
- 공개 주소여야 합니다. 사설 주소로 해석되는 호스트는 거절합니다.
- 주소에 아이디와 비밀번호를 넣을 수 없습니다. 예:
https://user:pass@example.com - 찾을 수 없는 호스트는 거절합니다.
- 리다이렉트는 따라가지 않습니다. 3xx 응답은 실패로 처리합니다.
이벤트를 받은 뒤 다시 읽기
이벤트의 ID는 API가 반환하는 값과 같아 바로 다시 읽을 수 있습니다.
휴지통에 있는 행은 200과
in_trash: true를 반환합니다. updated_blocks의 지운 블록 ID는 404를 반환합니다.