Caret API 개요 Caret은 미팅 전사, 번역, 메모 작성 기능을 애플리케이션에 통합할 수 있는 포괄적인 REST API를 제공합니다. 이 문서는 API를 사용하여 Caret과 강력한 통합을 구축하는 방법을 이해하는 데 도움을 드립니다.

주요 기능

  • 미팅 메모: 프로그래밍 방식으로 미팅 메모를 생성, 조회, 관리
  • 전사본: 상세한 미팅 전사본 및 번역에 액세스
  • 실시간 이벤트: 웹훅을 통한 실시간 알림 수신
  • 워크스페이스 관리: 프로그래밍 방식으로 워크스페이스 설정 및 사용자 관리

기본 URL

모든 API 요청은 다음 기본 URL로 보내야 합니다:
https://api.caret.so/v1

인증

Caret은 API 키를 사용하여 요청을 인증합니다. 워크스페이스 설정에서 API 키를 얻을 수 있습니다.
모든 API 요청에는 Authorization 헤더에 API 키가 포함되어야 합니다:
Authorization: Bearer sk-caret-api-xxxxxxxxxxxxxxxxxxxx
자세한 인증 지침은 인증 페이지를 참고하세요.

요청 제한

공정한 사용을 보장하기 위해 Caret은 API 요청에 대한 요청 제한을 구현합니다. 제한은 구독 플랜에 따라 다릅니다:
플랜분당 요청 수분당 웹훅 수
무료6020
프로12040
엔터프라이즈300100
요청 제한 및 처리 방법에 대한 자세한 내용은 요청 제한 문서를 참고하세요.

사용 가능한 리소스

메모

메모는 Caret API의 핵심 리소스입니다. 관련 메타데이터, 전사본, 요약이 포함된 미팅 메모를 나타냅니다.
  • 메모 목록 가져오기
  • 새 메모 생성
  • 특정 메모 조회
  • 메모 업데이트
  • 메모 삭제
메모의 전체 구조는 메모 모델 문서를 참고하세요.

웹훅

웹훅을 사용하면 애플리케이션이 Caret의 이벤트에 대한 실시간 알림을 받을 수 있습니다.
  • 메모 생성
  • 오디오 업로드
  • 기타 이벤트들
웹훅 설정 및 관리 방법은 웹훅 문서를 참고하세요.

오류 처리

Caret API는 HTTP 응답 코드를 사용하여 요청의 성공 또는 실패를 나타냅니다. 오류 처리에 대한 자세한 정보는 오류 처리 페이지를 참고하세요.

시작하기

Caret API 사용을 시작하려면:
  1. 워크스페이스 설정에서 API 키 생성
  2. 이 문서에서 사용 가능한 엔드포인트 및 모델 탐색
  3. 실시간 이벤트 수신을 위한 웹훅 설정
자세한 예제는 개발자 리소스 섹션을 확인하세요.