API 빠른 시작
이 가이드는 처음부터 첫 성공 요청까지 안내합니다: 개인 토큰 생성, 기본 주소 확인, REST 엔드포인트 호출.
1단계. 개인 토큰 생성
개인 계정의 개인 토큰 섹션에서 새 토큰(PAT)을 생성합니다. 값을 즉시 복사하세요 — 단 한 번 표시되며 mbp_ 접두사로 시작합니다. 생성 시 작업에 충분한 접근 범위(scopes)를 선택하세요. 자세한 내용은 인증 가이드를 참조하세요.
2단계. 기본 주소와 형식
모든 REST 엔드포인트는 /api 접두사 아래에 있습니다. 경로에는 버전이 없습니다. 요청/응답 본문은 JSON이며, 본문이 있는 요청에는 Content-Type: application/json 헤더를 전달하세요. 토큰은 Authorization: Bearer mbp_… 헤더로 전달합니다.
3단계. 첫 번째 요청 — 봇 목록
봇 목록 요청으로 토큰을 확인하세요. bots:read 범위(또는 *)가 필요합니다:
curl -H "Authorization: Bearer mbp_YOUR_TOKEN" https://your-domain/api/bots
응답으로 봇의 JSON 배열이 반환됩니다. 토큰이 잘못되었거나 만료된 경우 {"error":"..."} 본문과 함께 401이 반환됩니다 (오류 참조).
4단계. 첫 번째 변경 — 반응 생성
반응 생성에는 reactions:write 범위가 필요합니다. 3단계의 봇 식별자를 입력하세요:
curl -X POST -H "Authorization: Bearer mbp_YOUR_TOKEN" -H "Content-Type: application/json" -d '{"name":"안녕하세요","trigger":{"type":"command","value":"/start"}}' https://your-domain/api/bots/BOT_ID/reactions
성공 응답으로 id가 포함된 생성된 반응이 반환됩니다. 본문 필드의 정확한 내용은 인터랙티브 레퍼런스에서 확인하세요 — 각 엔드포인트별로 curl, JavaScript, Python 예시가 생성됩니다.
5단계. 이후 — 레퍼런스로
토큰이 작동하면 나머지는 인터랙티브 레퍼런스에서 탐색하는 것이 편리합니다: 전체 엔드포인트 목록, 필요한 scopes, 본문 스키마, 'Try it' 버튼이 있습니다.