# 开发者服务中心
> 介绍全景列表与详情接口的字段说明及使用注意事项。

## 1. 页面信息

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

## 2. 功能说明

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

## 3. 业务说明

### 能力概览

| 能力 | 用途 |
| --- | --- |
| 全景列表 | 按分页获取账号下的全景作品列表 |
| 全景详情 | 按全景 ID 获取单个全景的详细信息 |

### 状态字段含义

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

### 安全提醒

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

## 4. 使用说明

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

## 5. 规则与限制

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

## 6. 状态与异常

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

## 7. 相关文档

- [开发者工作台](https://9kvr.cn/site/user/develop/workbench.md)
- [插件市场](https://9kvr.cn/site/user/develop/plugins.md)
- 上级目录索引：[/user](https://9kvr.cn/site/user/llms.txt)

## 8. 文档信息

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