更新 YCM 用户的订阅信息

更新指定下级 YCM 用户云 PBX 套餐包的订阅信息。

请求 URL

PUT {base_url}/open_api/v1/users/{userId}/subscription_info

请求参数

路径参数
参数 是否必填 类型 说明
userId 是 Long YCM 用户 ID。
注： 可使用 查询所有 YCM 用户 接口查询用户 ID。
请求头
参数 是否必填 类型 说明
Authorization 是 String 在请求头中传递访问 Token。

格式：Bearer {access_token}。
请求体
参数 是否必填 类型 说明
totalExtensions 是 Integer 总的分机数。
totalConcurrentCalls 是 Integer 总的并发数。
totalRecordings 是 Integer 总的通话录音分钟数。
注： 不允许减少通话录音分钟数。
minimumExtPerPbx 是 Integer 每台 PBX 最小分机数。
totalUltimatePlan 否 Integer 总的旗舰版 (UP) 分机数。
highAvailability 否 String 是否启用高可用服务。
取值范围：
  • subscribed：启用
  • unsubscribed：禁用
totalCustomDomains 否 Integer 用户在每个区域中可配置的自定义域名总数。
totalConnections 否 Integer 总的远程连接数。
totalTranscription 否 Integer 总的 AI 语音转写分钟数 (一次性容量)。
totalAiReceptionist 否 Integer 总的 AI 接待员分钟数 (一次性容量)。
totalTranscriptionPack 否 Integer 总的 AI 语音转写月容量包数量。
totalAiReceptionistPack 否 Integer 总的 AI 接待员月容量包数量。

响应参数

参数 类型 说明
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。

示例

请求示例

更新 YCM 用户 (ID：13123) 的订阅信息。
PUT /dm/open_api/v1/users/13123/subscription_info HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2NjQ0MzQ0NzN9LCJzY29wZSI6WyJhbGwiXSwiZXhwIjoxNjY0NDM2MjczLCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJkZjBkMjY0Zi01NTExLTRjZmYtODAxNC1kNDk1NzI5MWU1YjIiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.vyjCNtFkaEgGIUROdJFHPRiiMefKkXNg5pEBHtnWz8E
Content-Type: application/json
{
  "totalExtensions": 60,
  "totalConcurrentCalls": 8,
  "totalRecordings": 60,
  "minimumExtPerPbx": 11,
  "totalUltimatePlan":20,
  "highAvailability": unsubscribed,
  "totalCustomDomains":1,
  "totalConnections":5,
  "totalTranscription":200,
  "totalAiReceptionist":500,
  "totalTranscriptionPack":1,
  "totalAiReceptionistPack":1
}
响应示例
HTTP/1.1 200 OK
{
  "requestId": "2ffe14a1e92bc4ae222353c60758cc2e",
  "status": "Success",
  "time": 1664434539
}