Skip to Content
고급 기능API 키 관리
6. 응용 기능

API 키 관리

API 키를 발급하면 외부 시스템이나 프로그램에서 모코보이스 API를 호출할 수 있습니다. API 키는 팀에서 공유되는 인증 정보입니다. 필요한 연동 대상에게만 전달하고, 더 이상 필요하지 않으면 삭제해 주세요.

API 키 관리 페이지 열기

법인 계정의 경우 팀 설정을 열고 연동 안에 있는 API 연동에서 API 키 관리 페이지 열기를 누릅니다.

개인 계정의 경우 내 정보에서 API 연동을 엽니다.

操作 화면 예시API 키 관리 페이지
営業チーム/チーム設定
モコボイス APIキー
モコボイス APIを利用するためのAPIキーを管理します。APIキーはチームで共有されます。
APIの使い方やエンドポイントの詳細はAPIドキュメントで確認できます。APIドキュメントを開く
APIキーを作成
‹1›
名前権限APIキー作成日時
外部連携用
READWRITE
●●●●●
2026/05/16 10:30
‹1›
참고

API 키를 사용하고 관리할 수 있는 것은 관리 역할뿐입니다. 편집·제출·열람 역할에서는 사용할 수 없습니다.

API 키 발급하기

  1. API 키 만들기를 누릅니다.
  2. 연동 대상을 알 수 있는 이름을 입력합니다. 예: 외부 시스템 연동, 배치 처리용
  3. 만들기를 누릅니다.
API 키 만들기
이름
CRM 연동용

기본적으로 READ, WRITE 권한이 부여됩니다.

취소만들기

만든 후에는 목록에 API 키가 추가됩니다. 권한은 필요에 따라 목록의 편집 아이콘에서 변경할 수 있습니다.

복사해서 안전하게 보관하기

목록의 복사 아이콘을 누르면 API 키를 클립보드에 복사할 수 있습니다. 화면에서는 moco_1234••••••••abcd와 같은 샘플 표시를 사용하며, 실제 키를 채팅, 이메일, 문서에 붙여넣지 마세요.

복사한 키는 연동 대상 시스템의 시크릿 관리 기능이나 환경 변수 등 접근이 제한된 곳에 저장합니다. API 키는 모코보이스 API를 호출할 때의 인증 정보로, API 문서에서 지정된 요청 헤더 등에 설정합니다.

MOCOVOICE_API_KEY="moco_1234••••••••abcd"

확인 단계를 사용하는 팀

공유 전에 확인 단계 추가가 켜져 있으면 API에서 시작한 받아쓰기도 확인 대기 상태가 됩니다. 확인이 완료될 때까지 일반 받아쓰기 목록·상세 API에 표시되지 않으며, Webhook 같은 외부 연동도 실행되지 않습니다.

승인 상태만 확인하려면 다음 전용 API를 사용합니다.

GET /api/v1/transcriptions/{transcription_id}/approval-status
{
  "approval_status": "PENDING_APPROVAL",
  "approval_requested_at": "2026-07-20T15:00:00+09:00",
  "approved_at": null,
  "rejection_reason": null
}

approval_status는 DRAFT(작업 중), PENDING_APPROVAL(확인 대기), APPROVED(공유됨), REJECTED(수정 요청 있음) 중 하나입니다.

기존 받아쓰기 API의 응답 형식은 변경되지 않습니다. 확인 단계를 사용하지 않는 기존 팀은 연동 시스템을 변경할 필요가 없습니다.

API 키 삭제하기

연동을 중단하거나, 키가 외부에 유출되었을 가능성이 있거나, 사용자가 바뀐 경우 등에는 API 키를 삭제합니다.

  1. 목록에서 대상 API 키를 확인합니다.
  2. 오른쪽 끝의 삭제 아이콘을 누릅니다.
  3. 확인 화면에서 API 키 삭제를 누릅니다.
API 키 「외부 연동용」 삭제

정말 삭제하시겠습니까? 이 작업은 되돌릴 수 없습니다.

취소API 키 삭제

삭제한 API 키는 더 이상 사용할 수 없습니다. 같은 연동을 계속하려면 새 API 키를 만들어 연동 대상 시스템의 설정을 업데이트해 주세요.

최근 업데이트