본문으로 건너뛰기

REST API & 웹훅 Team

플랜

REST API, 웹훅 및 API 키는 Team 및 Enterprise에서 사용할 수 있습니다. 플랜 & 결제를 참고하세요.

스크린샷 자리 표시자 — 📷 촬영 대상: API 키 & 웹훅 설정 (target: /img/handbook/ai/rest-api-webhooks.png).

회의 데이터를 사용 중인 스택으로 가져오세요. REST API로 구조화된 노트와 전사 기록을 가져오고, 노트가 준비되는 즉시 웹훅을 받아 Slack, CRM, 데이터 웨어하우스로 자동 전달할 수 있습니다.

인증

웹 앱에서 설정 → 개발자를 엽니다.
팀용 API 토큰을 생성합니다.
각 요청에 베어러 토큰으로 전송합니다.

curl https://platform.scribx.app/api/v1/recordings \
  -H "Authorization: Bearer YOUR_API_TOKEN"

토큰은 팀 단위로 범위가 지정되며 언제든지 취소할 수 있습니다.

가져올 수 있는 데이터

녹화 — 메타데이터와 함께 회의 목록 조회 및 가져오기
전사 기록 — 화자 라벨과 타임스탬프가 포함된 전체 대사
요약 — 구조화된 노트와 실행 항목

항상 최신 상태로 유지되는 전체 스키마는 설정 → 개발자에서 링크된 인앱 API 레퍼런스(Swagger UI)에서 확인할 수 있습니다.

웹훅

웹훅 URL을 등록하면 ScribX가 주요 이벤트 발생 시 해당 URL로 POST 요청을 보냅니다. 가장 유용한 경우는 회의의 노트가 준비되었을 때입니다.

설정 → 개발자에서 웹훅 엔드포인트를 추가합니다.
구독할 이벤트를 선택합니다.
엔드포인트가 녹화 id와 이벤트 유형이 담긴 JSON 페이로드를 받으면, API로 상세 정보를 가져옵니다.

{
  "event": "recording.note_ready",
  "recording_id": "rec_…",
  "team_id": "proj_…"
}

팁

페이로드를 검증한 뒤 2xx로 신속히 응답하고, 무거운 처리는 비동기로 수행하세요. ScribX는 2xx가 아닌 응답에 대해 재시도합니다.

다음 단계

인증
가져올 수 있는 데이터
웹훅
다음 단계