如何调用萤石 RTC 应用配置接口？
配置RTC应用接口
- 接口功能
该接口用于配置RTC项目。当参数appid为空时，将创建一个项目，并且返回appId。当参数不为空时，将修改该项目。
- 请求地址
https://open.ys7.com/api/v3/rtc/project
- 请求方式
PUT
- 请求参数
| 参数位置 | 参数名 | 类型 | 描述 | 是否必选 |
|---|---|---|---|---|
| Header | accessToken | String | 萤石开放API访问令牌 | Y |
| Body | bizTypes | String | 业务类型：1-实时音视频，2-远程控制，3-多屏互动，4-视频客服。可多值，用西文逗号分隔。示例：'1,2' | N |
| Body | appId | String | RTC应用ID，当参数appid为空时，将创建一个项目，并且返回appId。当参数不为空时，将修改该项目。 | N |
| Body | name | String | 项目名 | Y |
| Body | intro | String | 项目介绍 | Y |
- 请求示例
curl --location --request PUT 'https://open.ys7.com/api/v3/rtc/project' \ --header 'accessToken: at.xxxxx' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'bizTypes=1,2' \ --data-urlencode 'name=myProject' \ --data-urlencode 'intro=myIntro'- 返回数据
{ "data": { "appId": "65b6c37b4adf43f3aa753e60910b9f27" }, "meta": { "code": 200, "message": "操作成功", "moreInfo": null } }- 返回字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| data | Object | 响应结果，appId为空时返回 |
| -appId | String | RTC应用ID |
| meta | Object | 响应元信息 |
| -code | String | 响应码 |
| -message | String | 响应信息 |
| -moreInfo | Object | 更多信息 |
- 返回码
| 返回码 | 返回消息 | 描述 |
|---|---|---|
| 49999 | 数据异常 | 数据异常 |
| 10002 | accessToken过期或异常 | accessToken过期或异常 |
| 400 | 参数错误 | 参数错误 |
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。