CallaboDevelopersBeta
문서 메뉴

시작하기

빠른 시작

PAT 발급부터 최근 회의의 대화록과 인사이트 조회까지 한 흐름으로 실행합니다.

준비하기

  • Callabo 계정
  • PAT 사용이 허용된 워크스페이스
  • cURL을 실행할 터미널

PAT 발급

Callabo REST API는 개인용 PAT를 Bearer 토큰으로 받습니다.

PAT 발급 화면 열기

Authorization 헤더

모든 요청에 다음 헤더를 추가합니다.

Authorization: Bearer <PAT>

단계

  1. 1

    PAT를 발급합니다

    개인 설정에서 이름과 만료일을 정해 PAT를 발급하고 원문을 복사합니다.

  2. 2

    환경 변수에 저장합니다

    CALLABO_PAT에 토큰을 저장하고 소스 코드와 셸 기록에 남기지 않습니다.

  3. 3

    워크스페이스 slug를 찾습니다

    아래 요청으로 접근 가능한 워크스페이스를 확인합니다. 목록에는 PAT가 차단된 워크스페이스도 포함될 수 있습니다.

  4. 4

    최근 회의를 찾습니다

    레코드 목록의 첫 항목에서 id를 확인합니다.

  5. 5

    대화록과 인사이트를 포함합니다

    레코드 상세 요청에 include=dialogs,insights를 추가합니다.

워크스페이스 목록 요청

curl --request GET \
  --url "https://api.callabo.ai/v2/workspaces?status=created&limit=20" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $CALLABO_PAT"

최근 회의를 찾습니다

curl --request GET \
  --url "https://api.callabo.ai/v2/workspaces/your-workspace/records?order=rec_date&limit=20" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $CALLABO_PAT"

다음 요청

반환된 slug와 레코드 목록의 id를 사용해 /v2/workspaces/{slug}/records/{record_id}?include=dialogs,insights를 호출합니다. 목록의 slug만으로 워크스페이스 범위 API 호출 가능 여부는 알 수 없습니다.

문제가 생기면

  • 401: PAT의 누락, 만료 또는 오타를 확인합니다. 대상 워크스페이스에서 PAT가 차단 여부도 확인합니다.
  • 403: 인증 후 현재 역할에 해당 리소스의 권한이 있는지 확인합니다.
  • 404: slug와 record_id, 현재 사용자의 접근 범위를 확인합니다.

안전하게 사용하기

  • Git 저장소, 로그, 채팅, 문서에 토큰을 직접 입력하지 않습니다.
  • 환경 변수 또는 조직에서 승인한 비밀 저장소를 사용합니다.
  • 유출이 의심되면 기존 PAT를 즉시 폐기하고 새 PAT를 발급합니다.
© 2026 Return Zero, Inc.