开发者服务中心

介绍全景列表与详情接口的字段说明及使用注意事项。

1. 页面信息

• 网页地址：https://9kvr.cn/user/setting/document
• 所属模块：用户中心
• 页面用途：面向开发者介绍如何通过服务端接口获取全景列表与全景详情，并列出返回字段与请求字段的含义，同时提醒接口须在服务端调用、切勿在前端直接调用。
• 适用用户：需要把全景数据接入自有系统的开发者
• 访问条件：公开访问

2. 功能说明

• 说明全景列表与全景详情两类数据获取能力
• 返回字段说明：全景 ID、名称、简介、封面图、地址、发布时间、状态、生成状态、类型、播放地址、分页信息等
• 请求字段说明：每页条数、接口校验 Key 等
• 顶部提示接口须在服务端使用，切勿前端直接调用

3. 业务说明

能力概览

状态字段含义

全景状态用于标识作品审核情况（审核中、审核通过、审核未通过），生成状态用于标识作品制作情况（制作中、制作成功、制作失败）；全景类型区分为全景与视频。

安全提醒

相关接口需要接口校验 Key，必须在服务端调用，切勿在浏览器前端直接请求，以免校验凭据泄露。

4. 使用说明

1. 阅读接口说明与字段含义
2. 在服务端按说明调用对应接口获取数据

5. 规则与限制

• 接口须在服务端调用，禁止前端直接调用
• 调用需要有效的接口校验 Key

6. 状态与异常

• 默认展开接口说明折叠面板
• 无

7. 相关文档

• 开发者工作台
• 插件市场
• 上级目录索引：/user

8. 文档信息

• 事实来源：芊云全景官网页面与公开产品配置
• 文档构建时间：2026-10-20 19:04:23
• 数据获取/快照时间：不适用（静态产品知识）
• 可信状态：已核验