认证

所有API请求都必须使用API密钥进行认证。

基本URL

https://api.recordmeeting.com/v1

API 密钥认证

在 Authorization 头中包含您的 API 密钥：

Authorization: Bearer <your_api_key>

要创建 API 密钥，请参阅用户指南 → API 密钥。

请求示例

curl -X GET "https://api.recordmeeting.com/v1/recordings"
  -H "Authorization: Bearer rm_your_api_key_here"

错误响应

所有错误都遵循此格式：

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable description"
  }
}

认证错误代码

代码	HTTP 状态	含义
UNAUTHORIZED	401	Authorization 头缺失或格式错误
INVALID_API_KEY	401	密钥不存在或已被撤销
API_KEY_EXPIRED	401	密钥已过期
USER_NOT_FOUND	401	与密钥关联的用户不再存在
FORBIDDEN	403	已认证，但缺少此资源的权限

常见错误代码

代码	HTTP 状态	含义
RECORDING_NOT_FOUND	404	录制ID不存在或无法访问
RECORDING_LOCKED	403	该功能需要升级订阅
ORGANIZATION_SUBSCRIPTION_EXPIRED	402	拥有该录制的组织不再拥有有效的企业订阅
TRANSCRIPT_NOT_AVAILABLE	403	组织或成员已禁用转录功能
SHARING_DISABLED	403	组织或成员已禁用共享功能
VALIDATION_ERROR	400	请求参数无效或缺失
INTERNAL_ERROR	500	服务器端错误