文档

API 参考

查找端点,检查其需求,并理解结果。这些是 screenRIG 插件、播放器和控制台使用的 HTTP 操作。

发布到屏幕?从 插件设置 和 CLI 指南 开始。需要底层请求时请参考此文档。

HTTP 参考。 由后端契约生成。浏览以下端点或下载 OpenAPI。

选择正确的服务

端点决定基础 URL 和凭证。以下请求模板使用声明的服务 URL。

你正在做什么服务身份验证
管理屏幕和内容api.screenrig.aiAgent 持有者令牌
运行播放器play.screenrig.ai浏览器 Cookie 或原生播放器凭据
管理登录和项目screenrig.ai/dashboard控制台Cookie
从身份提供者预配人员api.screenrig.ai/scim/v2组织 SCIM 令牌
加载应用发布版本其确切主机位于 apps.screenrig.ai 下启动票据或发布cookie

原生播放器在设置期间使用 ScreenRig-Pairing,之后使用 ScreenRig-Session。这些请求不得包含 Cookie。浏览器端点使用自己的 Cookie。

下面使用的身份验证名称
projectBearer
捆绑 CLI 使用的活动代理令牌,绑定到唯一一个项目。
功能区域
每个智能体凭证包含固定的区域集:screens、content、playlists、advertising、reports 和 project。凭证仅调用其区域内的路由;reports 还可读取任何区域。请求指定缺失区域时返回 403 forbidden,详情为“此智能体凭证缺少 <name> 功能。”请连接具备所需功能的新智能体安装以恢复。
revocableAgentBearer
调用代理令牌,接受重试自身断开连接。
配对、设备和运行时 Cookie
Browser 播放器凭据。每个端点会指定可接受的 cookie。
dashboard 会话 cookie
已登录人员的会话和选定项目。独立的 __Host-screenrig-signup Cookie 绑定链接邀请注册、电子邮件验证、凭证选项和接受。两个 Cookie 均非代理凭证。可批准的人员使用它在控制台的页面编辑器中创建和替换播放列表。
primitiveCapability
从播放列表原语短期访问单个应用的键值存储。
demoSession
私有网站演示会话,独立于项目和仪表板凭据。网站在接收或私有邀请后设置;流程标识符不授权访问。
scimBearer
组织的 SCIM 预配令牌,仅被 /scim/v2 路由接受。它绝不是项目、智能体或控制台凭证。
ssoTransaction
将单点登录绑定到发起它的浏览器的 Cookie。
operatorBearer
服务操作员访问。

人员、项目和邀请

某人有一个登录,可属于多个项目。注册总是创建新项目并向其联系邮箱发送项目成员邀请。智能体建议项目名称;每个智能体令牌绑定该项目。

控制台列出该人的项目,并切换所选项目以进行 Cookie 认证操作。个人电子邮件和通行密钥属于登录,不属于项目。

邀请支持创建、列出、撤销和接受流程。项目成员默认通过电子邮件接收;明确请求的成员链接仅返回给其创建者。广告买家邀请仅限电子邮件。电子邮件邀请七天后过期,成员链接二十四小时后过期。新用户创建通行密钥;现有用户在接受前登录。链接注册会验证用户电子邮件后创建登录。

登录重置仅限邮箱,1小时后过期,并替换该人的登录凭据,同时撤销其其他会话。请求确认不会透露邮箱是否有登录。打开控制台是导航行为,不是授权。

常见请求语义

  • 幂等:当端点接受Idempotency-Key时,丢失响应后重用该键和相同请求;不匹配则返回409 idempotency_mismatch。
  • 修订: 当接口要求 If-Match 时,发送当前资源修订;过时写入返回 412 revision_conflict。
  • 游标:列表和 SSE 游标是不可见的。
  • 操作:上传可能在receiving开始,然后使用queued、running、succeeded、failed或cancelled。
  • SSE: 使用最后的游标或 Last-Event-ID 恢复。一个 stream.resync_required 帧表示重新获取权威状态并从其提供的头游标恢复。
  • 限制:权限发布活动限制;速率限制返回429 rate_limited。

凭证持久性属于插件流程。 捆绑的 CLI 读取可替换插件目录外的平台配置。

上传生命周期

应用

提交已构建的确定性归档,等待验证、提取和不可变发布。screenRIG 处理打包的静态输出。

媒体

声明确切的类型、大小和哈希;严格遵循签名的原始 PUT 方法和头;提交并等待。将签名的 URL 和头视为凭证。

运行时和受保护内容

配对、设备/运行时会话、清单、报告、事件、启动票据和运行时 K/V 均存在于受信任的播放器源。清单媒体支持合同定义的范围;发布资产使用精确的隔离主机。授权的本地播放器会话通过清单和发布绑定的受保护路径接收规范化的不可变 webapp 包。

内容遵循当前屏幕权限。 发布、包和 K/V 访问权限源自当前屏幕清单授权;媒体服务于拥有该项目的屏幕。原生包权限绑定当前屏幕、清单版本、发布身份、包哈希、大小、类型和设备会话;存储保持私有,交付由服务器中介。

完成端点清单

41 个分组共 740 个操作,由 api/openapi.yaml 生成。每个分组都有独立页面,列出每个操作的参数、请求字段、请求模板和响应。

服务元数据、能力和文档搜索

6 个操作,含各自的参数、请求模板和响应。

项目、邀请和登录

147 个操作,含各自的参数、请求模板和响应。

套餐、额度余额及账单

6 个操作,含各自的参数、请求模板和响应。

智能体安装和连接

3 个操作,含各自的参数、请求模板和响应。

OAuth 登录、令牌和撤销

10 个操作,含各自的参数、请求模板和响应。

单点登录:登录路由、身份提供者和策略

13 个操作,含各自的参数、请求模板和响应。

用户预配:SCIM 2.0、令牌和群组绑定

24 个操作,含各自的参数、请求模板和响应。

服务客户端

9 个操作,含各自的参数、请求模板和响应。

应用和操作

11 个操作,含各自的参数、请求模板和响应。

媒体上传

38 个操作,含各自的参数、请求模板和响应。

播放列表

16 个操作,含各自的参数、请求模板和响应。

屏幕

84 个操作,含各自的参数、请求模板和响应。

活动

10 个操作,含各自的参数、请求模板和响应。

排程导入:排程行工作表

3 个操作,含各自的参数、请求模板和响应。

代理更改的审核

7 个操作,含各自的参数、请求模板和响应。

私有广告网络和广告活动

46 个操作,含各自的参数、请求模板和响应。

评论

9 个操作,含各自的参数、请求模板和响应。

项目备注由智能体共享

5 个操作,含各自的参数、请求模板和响应。

应用键值存储

9 个操作,含各自的参数、请求模板和响应。

  • 列出 KV GET /api/applications/{application_id}/kv
  • 获取 KV GET /api/applications/{application_id}/kv/{key}
  • 放置 KV PUT /api/applications/{application_id}/kv/{key}
  • 删除 KV DELETE /api/applications/{application_id}/kv/{key}
  • 列出 KVWebhook GET /api/applications/{application_id}/kv-webhooks
  • 创建 KVWebhook POST /api/applications/{application_id}/kv-webhooks
  • 删除 KVWebhook DELETE /api/applications/{application_id}/kv-webhooks/{webhook_id}
  • 轮换 KVWebhook 密钥 POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/rotate-secret
  • 接收 KVWebhook POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write

内置卡片的数据

22 个操作,含各自的参数、请求模板和响应。

数据源:让卡片保持最新的地址

10 个操作,含各自的参数、请求模板和响应。

BI 仪表板:Power BI、Tableau 和需要登录的网页的连接与视图

14 个操作,含各自的参数、请求模板和响应。

连接:项目可重复使用的 Microsoft 和 Google 访问权限

9 个操作,含各自的参数、请求模板和响应。

持久项目事件

2 个操作,含各自的参数、请求模板和响应。

通知:在屏幕状态变化时发送电子邮件和带签名的 Webhook 提醒

13 个操作,含各自的参数、请求模板和响应。

警报:未解决的屏幕问题、确认、暂缓与静音

6 个操作,含各自的参数、请求模板和响应。

报告:按文件夹和标签的汇总、CSV、XLSX 和 PDF 文件以及邮件定时发送

8 个操作,含各自的参数、请求模板和响应。

审计日志:每一次配置变更及其变更前和变更后、可验证的哈希链,以及 CSV、XLSX 和 PDF 导出

4 个操作,含各自的参数、请求模板和响应。

Webhooks:签名事件传递

9 个操作,含各自的参数、请求模板和响应。

CAP 警报触发器

12 个操作,含各自的参数、请求模板和响应。

播放汇总

4 个操作,含各自的参数、请求模板和响应。

反馈:错误报告和功能请求

6 个操作,含各自的参数、请求模板和响应。

支持

9 个操作,含各自的参数、请求模板和响应。

网站演示请求和预订

7 个操作,含各自的参数、请求模板和响应。

主页浏览器交接

6 个操作,含各自的参数、请求模板和响应。

网站设置码

1 个操作,含其参数、请求模板和响应。

播放器配对和会话

12 个操作,含各自的参数、请求模板和响应。

运行时清单、报告和事件

24 个操作,含各自的参数、请求模板和响应。

运行时应用 K/V

4 个操作,含各自的参数、请求模板和响应。

受保护内容和发布资产

8 个操作,含各自的参数、请求模板和响应。

人员和项目控制台

94 个操作,含各自的参数、请求模板和响应。

API 生命周期、弃用和速率限制

URL系列包括/api、/screen、/stream、/media、/website、/agentid。主版本内兼容更改:

  • 加法端点和方法。
  • 可选请求成员。
  • 新的问题代码。
  • 仅在发布的架构允许未知字段时新增字段。
  • 移除仅返回错误或无客户端调用的操作。
  • 移除没有客户端使用的响应字段。

这些更改需要新的主版本:

  • 工作路由或客户端调用字段的移除或重命名。
  • 类型、含义或授权更改。
  • 将可选输入设为必填。
  • 向封闭枚举添加成员。
  • 向封闭响应对象添加字段。

新主版本至少重叠 180 天。日落通知至少 90 天,弃用操作自 RFC 9745 弃用生效日起至少继续提供 90 天,除非后续发布的承诺另有规定。

当前无弃用操作。

生命周期信号包括:

  • OpenAPI 在操作上标记为已弃用。
  • RFC 9745 废弃及其生效日期。
  • RFC 8594 一旦确定日落日期即停止使用。
  • 带有 rel=deprecation 的链接到迁移文档。

速率限制字段

带有公开固定窗口控制的操作声明了x-rate-limit-policies。符合条件的允许响应可能包括可选的RateLimit-Policy和RateLimit结构化字段列表成员。完全重放和无共享许可的部署可能省略它们。固定窗口拒绝包含它们;并发和字节预算拒绝可能省略它们。这些字段遵循draft-ietf-httpapi-ratelimit-headers-11,这是一个Internet-Draft而非RFC。在每个429上,Retry-After是权威的。

RFC 9457 问题

错误使用 application/problem+json。分支于 status 和稳定的 code;将 detail 视为说明。由 problems.yaml 生成。

project_required

400 · 请选择一个项目

类型:https://screenrig.ai/problems/project-required
free_organization_limit

409 · 免费组织限制已达上限

类型:https://screenrig.ai/problems/free-organization-limit
organization_plan_required

409 · 组织需要订阅计划后才能接纳屏幕

类型:https://screenrig.ai/problems/organization-plan-required
project_name_conflict

409 · 组织中项目名称已被使用

类型:https://screenrig.ai/problems/project-name-conflict
project_delete_blocked

409 · 当前状态下无法删除项目

类型:https://screenrig.ai/problems/project-delete-blocked
owner_required

409 · 需要负责人

类型:https://screenrig.ai/problems/owner-required
owner_cannot_leave

409 · 项目所有者无法离开

类型:https://screenrig.ai/problems/owner-cannot-leave
internal_error

500 · 服务器内部错误

类型:https://screenrig.ai/problems/internal-error
invalid_request

400 · 请求无效

类型:https://screenrig.ai/problems/invalid-request
unauthorized

401 · 需要身份验证

类型:https://screenrig.ai/problems/unauthorized
credential_retired

401 · 凭据已废止

类型:https://screenrig.ai/problems/credential-retired
client_update_required

410 · 请更新 screenRIG 插件或 CLI

类型:https://screenrig.ai/problems/client-update-required
forbidden

403 · 请求不被允许

类型:https://screenrig.ai/problems/forbidden
insufficient_access

403 · 此访问级别无法执行此操作

类型:https://screenrig.ai/problems/insufficient-access
outside_upload_scope

403 · 超出此上传者的播放列表和文件夹范围

类型:https://screenrig.ai/problems/outside-upload-scope
outside_screen_scope

403 · 超出此成员的屏幕范围

类型:https://screenrig.ai/problems/outside-screen-scope
protected_target

409 · 受保护的屏幕不能以这种方式更改

类型:https://screenrig.ai/problems/protected-target
second_approver_required

403 · 需要第二位审批人来决定此审核

类型:https://screenrig.ai/problems/second-approver-required
reserved_item

403 · 此活动已预留

类型:https://screenrig.ai/problems/reserved-item
approver_required

403 · 只有审批人可以执行此操作

类型:https://screenrig.ai/problems/approver-required
review_not_pending

409 · 审核不再处于待处理状态

类型:https://screenrig.ai/problems/review-not-pending
review_stale

409 · 提议之后主体已更改

类型:https://screenrig.ai/problems/review-stale
review_blocked

409 · 必须先决定另一个审核

类型:https://screenrig.ai/problems/review-blocked
playlist_not_approved

409 · 播放列表无已批准版本

类型:https://screenrig.ai/problems/playlist-not-approved
media_pending_review

409 · 媒体项正在等待人员审核

类型:https://screenrig.ai/problems/media-pending-review
media_sync_source_refused

409 · 媒体同步来源拒绝了该请求

类型:https://screenrig.ai/problems/media-sync-source-refused
media_sync_source_unavailable

500 · 无法连接到媒体同步来源

类型:https://screenrig.ai/problems/media-sync-source-unavailable
canva_not_configured

409 · Canva 尚未配置

类型:https://screenrig.ai/problems/canva-not-configured
canva_reconnect_required

409 · 需要连接 Canva 账户

类型:https://screenrig.ai/problems/canva-reconnect-required
dropbox_not_configured

409 · Dropbox 未配置

类型:https://screenrig.ai/problems/dropbox-not-configured
dropbox_reconnect_required

409 · 需要连接 Dropbox 账户

类型:https://screenrig.ai/problems/dropbox-reconnect-required
google_drive_not_configured

409 · Google Drive 未配置

类型:https://screenrig.ai/problems/google-drive-not-configured
media_sync_sharer_not_member

403 · 该文件夹不是由项目成员共享的

类型:https://screenrig.ai/problems/media-sync-sharer-not-member
not_found

404 · 未找到资源

类型:https://screenrig.ai/problems/not-found
method_not_allowed

405 · 方法不被允许

类型:https://screenrig.ai/problems/method-not-allowed
idempotency_mismatch

409 · 幂等键与原始请求不匹配

类型:https://screenrig.ai/problems/idempotency-mismatch
credential_issuance_expired

410 · 凭证签发已过期

类型:https://screenrig.ai/problems/credential-issuance-expired
user_email_conflict

409 · 电子邮件地址属于其他人员

类型:https://screenrig.ai/problems/user-email-conflict
provisioning_invalid

404 · 浏览器配置无效

类型:https://screenrig.ai/problems/provisioning-invalid
provisioning_expired

410 · 浏览器配置已过期

类型:https://screenrig.ai/problems/provisioning-expired
provisioning_consumed

409 · 浏览器配置已使用

类型:https://screenrig.ai/problems/provisioning-consumed
provisioning_exchange_mismatch

409 · 浏览器配置交换不匹配

类型:https://screenrig.ai/problems/provisioning-exchange-mismatch
browser_already_paired

409 · 浏览器已配对

类型:https://screenrig.ai/problems/browser-already-paired
handoff_code_invalid

404 · 浏览器交接代码无效

类型:https://screenrig.ai/problems/handoff-code-invalid
handoff_code_expired

410 · 浏览器交接码已过期

类型:https://screenrig.ai/problems/handoff-code-expired
handoff_session_rate_limited

429 · 浏览器交接会话限流

类型:https://screenrig.ai/problems/handoff-session-rate-limited
handoff_session_conflict

409 · 浏览器交接会话冲突

类型:https://screenrig.ai/problems/handoff-session-conflict
browser_link_not_claimed

409 · 浏览器链接未被认领

类型:https://screenrig.ai/problems/browser-link-not-claimed
browser_link_project_mismatch

403 · 浏览器链接项目不匹配

类型:https://screenrig.ai/problems/browser-link-project-mismatch
origin_not_allowed

403 · 来源不被允许

类型:https://screenrig.ai/problems/origin-not-allowed
resource_conflict

409 · 资源状态与请求冲突

类型:https://screenrig.ai/problems/resource-conflict
card_not_found

404 · 找不到卡片

类型:https://screenrig.ai/problems/card-not-found
card_invalid

400 · 卡片位置无效

类型:https://screenrig.ai/problems/card-invalid
card_layout_invalid

400 · 卡片布局无效

类型:https://screenrig.ai/problems/card-layout-invalid
card_layout_conflict

400 · 页面上的卡片声明了相同的位置

类型:https://screenrig.ai/problems/card-layout-conflict
card_data_invalid

409 · 卡片数据文档不适合读取它的卡片

类型:https://screenrig.ai/problems/card-data-invalid
source_limit_reached

409 · 组织的数据源数量已达上限

type: https://screenrig.ai/problems/source-limit-reached
source_target_unsupported

422 · 该数据源无法填充这张卡片

type: https://screenrig.ai/problems/source-target-unsupported
source_target_taken

409 · 已有另一个数据源在填充这张卡片

type: https://screenrig.ai/problems/source-target-taken
source_busy

409 · 数据源的同步正在运行

type: https://screenrig.ai/problems/source-busy
source_has_no_rooms

409 · 此类数据源不提供房间

type: https://screenrig.ai/problems/source-has-no-rooms
source_secret_required

400 · 数据源的密钥缺失或已不再适用

type: https://screenrig.ai/problems/source-secret-required
source_test_failed

422 · 数据源预览失败

type: https://screenrig.ai/problems/source-test-failed
connection_app_not_configured

409 · 此提供商未配置 screenRIG 的应用

类型:https://screenrig.ai/problems/connection-app-not-configured
connection_limit_reached

409 · 组织已达到最大连接数

类型:https://screenrig.ai/problems/connection-limit-reached
card_media_invalid

400 · 卡片媒体引用未指定准备好的图像

类型:https://screenrig.ai/problems/card-media-invalid
revision_conflict

412 · 资源版本不匹配

类型:https://screenrig.ai/problems/revision-conflict
invalid_range

416 · 请求的字节范围不可满足

类型:https://screenrig.ai/problems/invalid-range
quota_exceeded

413 · 项目内容配额已超限

类型:https://screenrig.ai/problems/quota-exceeded
payment_required

402 · 需要使用额度

类型:https://screenrig.ai/problems/payment-required
reseller_generation_limit

402 · 已达到经销商的图像生成上限

类型:https://screenrig.ai/problems/reseller-generation-limit
feature_not_in_plan

402 · 此功能不在项目的计划中

类型:https://screenrig.ai/problems/feature-not-in-plan
rate_limited

429 · 请求速率过高

类型:https://screenrig.ai/problems/rate-limited
revocation_unavailable

500 · 凭证吊销状态不可用

类型:https://screenrig.ai/problems/revocation-unavailable
dependency_unavailable

500 · 所需依赖不可用

类型:https://screenrig.ai/problems/dependency-unavailable
dependency_timeout

500 · 所需依赖未及时响应

类型:https://screenrig.ai/problems/dependency-timeout
schema_incompatible

500 · 数据库架构不兼容

类型:https://screenrig.ai/problems/schema-incompatible
not_ready

500 · 服务尚未就绪

类型:https://screenrig.ai/problems/not-ready
server_draining

421 · 服务正在排空

类型:https://screenrig.ai/problems/server-draining
manifest_degraded

500 · 运行时清单投影已降级

类型:https://screenrig.ai/problems/manifest-degraded
screenshot_unavailable

409 · 截图不可用

类型:https://screenrig.ai/problems/screenshot-unavailable
identity_invalid

400 · 播放器公钥无效

类型:https://screenrig.ai/problems/identity-invalid
identity_conflict

409 · 播放器公钥与注册信息不匹配

类型:https://screenrig.ai/problems/identity-conflict
enrollment_bound

409 · 播放器公钥已绑定到项目

类型:https://screenrig.ai/problems/enrollment-bound
proof_invalid

401 · 播放器身份验证无效

类型:https://screenrig.ai/problems/proof-invalid
screen_archived

409 · 屏幕已归档

类型:https://screenrig.ai/problems/screen-archived
screen_archive_required

409 · 归档屏幕,而不是删除或解绑

类型:https://screenrig.ai/problems/screen-archive-required
passkey_invalid

401 · 通行密钥流程无效

类型:https://screenrig.ai/problems/passkey-invalid
passkey_unknown

401 · 此通行密钥已不再注册

类型:https://screenrig.ai/problems/passkey-unknown
passkeys_disabled

403 · 此服务器禁用通行密钥

类型:https://screenrig.ai/problems/passkeys-disabled
application_in_use

409 · 仍有活动清单引用应用发布

类型:https://screenrig.ai/problems/application-in-use
agent_connection_invalid

404 · 智能体连接无效

类型:https://screenrig.ai/problems/agent-connection-invalid
agent_connection_code_mismatch

400 · 代码与此登录不匹配

类型:https://screenrig.ai/problems/agent-connection-code-mismatch
agent_connection_expired

410 · 智能体连接已过期

类型:https://screenrig.ai/problems/agent-connection-expired
agent_connection_conflict

409 · 智能体连接已解决

类型:https://screenrig.ai/problems/agent-connection-conflict
agent_connection_not_approved

409 · 智能体连接未获批准

类型:https://screenrig.ai/problems/agent-connection-not-approved
agent_limit_exceeded

409 · 超过智能体限制

类型:https://screenrig.ai/problems/agent-limit-exceeded
agent_lockout_risk

409 · 断开最后一个活动智能体可能导致锁定

类型:https://screenrig.ai/problems/agent-lockout-risk
recovery_ambiguous

409 · 设备标识符已绑定到多个屏幕

类型:https://screenrig.ai/problems/recovery-ambiguous
recovery_expired

410 · 屏幕恢复提议已过期

类型:https://screenrig.ai/problems/recovery-expired
recovery_not_offered

404 · 没有待处理的屏幕恢复

类型:https://screenrig.ai/problems/recovery-not-offered
invitation_limit_reached

409 · 组织已达到最大未处理邀请数

类型:https://screenrig.ai/problems/invitation-limit-reached
organization_admin_limit

409 · 组织管理员限制已达上限

类型:https://screenrig.ai/problems/organization-admin-limit
library_no_screens

409 · 有屏幕的项目不能用作媒体库

类型:https://screenrig.ai/problems/library-no-screens
guest_not_allowed

403 · 组织不准许此人作为访客

类型:https://screenrig.ai/problems/guest-not-allowed
managed_member

409 · 身份提供者管理此人员

类型:https://screenrig.ai/problems/managed-member
organization_admin_member

409 · 此成员是组织管理员

类型:https://screenrig.ai/problems/organization-admin-member
member_owns_projects

409 · 此成员拥有组织中的项目

类型:https://screenrig.ai/problems/member-owns-projects
managed_elsewhere

409 · 另一个组织管理此人员

类型:https://screenrig.ai/problems/managed-elsewhere
version_required

409 · 播放列表需要更新的 API 版本

类型:https://screenrig.ai/problems/version-required
price_change_pending

409 · 广告活动暂停,等待接受新费率

类型:https://screenrig.ai/problems/price-change-pending
quote_stale

409 · 广告报价已过期或失效

类型:https://screenrig.ai/problems/quote-stale
insufficient_credits

402 · 可用额度不足

类型:https://screenrig.ai/problems/insufficient-credits
self_deal

409 · 项目不能在自己的网络中购买广告

类型:https://screenrig.ai/problems/self-deal
goal_overbooked

409 · 目标大于可用播放次数

type: https://screenrig.ai/problems/goal-overbooked
invitation_invalid

404 · 邀请无效

类型:https://screenrig.ai/problems/invitation-invalid
invitation_expired

410 · 邀请已过期

类型:https://screenrig.ai/problems/invitation-expired
invitation_consumed

409 · 邀请已被接受

类型:https://screenrig.ai/problems/invitation-consumed
invitation_email_mismatch

403 · 邀请属于不同的电子邮件地址

类型:https://screenrig.ai/problems/invitation-email-mismatch
reauthentication_required

401 · 需要新的登录证明

类型:https://screenrig.ai/problems/reauthentication-required
member_limit_reached

409 · 项目成员已达最大数

类型:https://screenrig.ai/problems/member-limit-reached
project_limit_reached

409 · 组织已达到最大项目数

type: https://screenrig.ai/problems/project-limit-reached
billed_by_reseller

409 · 该组织通过其经销商计费

类型:https://screenrig.ai/problems/billed-by-reseller
reseller_conflict

409 · 该组织不能承担该经销商角色

类型:https://screenrig.ai/problems/reseller-conflict
last_credential

409 · 无法移除最后一次登录方式

类型:https://screenrig.ai/problems/last-credential
sso_required

403 · 此地址通过其身份提供者登录

类型:https://screenrig.ai/problems/sso-required
no_project

409 · 未选择当前项目

类型:https://screenrig.ai/problems/no-project
feature_unavailable

404 · 此功能在此服务器上不可用

类型:https://screenrig.ai/problems/feature-unavailable
user_binding_stale

409 · 认领用户电子邮件绑定已过期

类型:https://screenrig.ai/problems/user-binding-stale
session_expired

401 · 运行时会话已过期或不再有效

类型:https://screenrig.ai/problems/session-expired
credential_revoked

401 · 设备凭据不再将此设备绑定到屏幕

类型:https://screenrig.ai/problems/credential-revoked
screen_link_invalid

401 · 屏幕链接无效

类型:https://screenrig.ai/problems/screen-link-invalid
screen_link_not_found

404 · 屏幕没有链接

类型:https://screenrig.ai/problems/screen-link-not-found
proof_clock_skew

401 · 播放器身份验证超出接受的时间窗口

类型:https://screenrig.ai/problems/proof-clock-skew
key_retired

401 · 播放器密钥已被替换且宽限期已结束

类型:https://screenrig.ai/problems/key-retired
assignment_not_found

404 · 屏幕没有播放列表分配

类型:https://screenrig.ai/problems/assignment-not-found
upgrade_required

403 · 播放器版本低于支持的最低版本

类型:https://screenrig.ai/problems/upgrade-required
reboot_unsupported

409 · 屏幕无法远程重启

类型:https://screenrig.ai/problems/reboot-unsupported
command_unsupported

409 · 屏幕无法远程执行此操作

类型:https://screenrig.ai/problems/command-unsupported
play_page_unsupported

409 · 屏幕无法按请求播放页面

类型:https://screenrig.ai/problems/play-page-unsupported
identify_unsupported

409 · 屏幕无法标识自身

类型:https://screenrig.ai/problems/identify-unsupported
page_not_on_screen

409 · 页面不在屏幕播放的播放列表中

类型:https://screenrig.ai/problems/page-not-on-screen
live_unsupported

409 · 屏幕无法显示实时视图

类型:https://screenrig.ai/problems/live-unsupported
live_unavailable

409 · 此屏幕无法使用实时视图

类型:https://screenrig.ai/problems/live-unavailable
live_not_ready

409 · 屏幕尚未开始推流

类型:https://screenrig.ai/problems/live-not-ready
live_session_ended

410 · 实时会话已结束

类型:https://screenrig.ai/problems/live-session-ended
wall_unsupported

409 · 屏幕无法布局视频墙

类型:https://screenrig.ai/problems/wall-unsupported
playlist_format_mismatch

409 · 播放列表格式与屏幕视频墙不匹配

类型:https://screenrig.ai/problems/playlist-format-mismatch
primitive_locked

403 · 已锁定的元素只有可以审批的人才能更改

类型:https://screenrig.ai/problems/primitive-locked
playlist_is_template

409 · 该播放列表是模板

类型:https://screenrig.ai/problems/playlist-is-template
webhook_limit_reached

409 · 组织已达到最大 webhook 数

类型:https://screenrig.ai/problems/webhook-limit-reached
alert_not_open

409 · 警报未处于打开状态

type: https://screenrig.ai/problems/alert-not-open
alert_mute_limit_reached

409 · 组织的静音数已达上限

type: https://screenrig.ai/problems/alert-mute-limit-reached
notification_limit_reached

409 · 组织的通知数已达上限

type: https://screenrig.ai/problems/notification-limit-reached
notification_covers_other_projects

409 · 通知覆盖其他项目

类型:https://screenrig.ai/problems/notification-covers-other-projects
report_subscription_limit_reached

409 · 组织的报告订阅数已达上限

type: https://screenrig.ai/problems/report-subscription-limit-reached
fleet_link_limit_reached

409 · 组织已达到最大车队链接数

类型:https://screenrig.ai/problems/fleet-link-limit-reached
webhook_url_rejected

400 · Webhook URL 必须是公共互联网主机上的 HTTPS

类型:https://screenrig.ai/problems/webhook-url-rejected
notification_destination_rejected

400 · 通知目标对其渠道无效

类型:https://screenrig.ai/problems/notification-destination-rejected
document_not_shared

400 · 该文档要求查看者登录

type: https://screenrig.ai/problems/document-not-shared
note_contains_credential

422 · 备注文本包含凭证

类型:https://screenrig.ai/problems/note-contains-credential
note_rejected

422 · 备注文本被拒绝

类型:https://screenrig.ai/problems/note-rejected
note_not_open

409 · 备注未开启

类型:https://screenrig.ai/problems/note-not-open
note_limit_reached

409 · 组织已达到最大未关闭备注数

类型:https://screenrig.ai/problems/note-limit-reached
trigger_limit_reached

409 · 组织已达到最大触发器数

类型:https://screenrig.ai/problems/trigger-limit-reached
bi_upstream_refused

409 · BI 系统拒绝了该连接

类型:https://screenrig.ai/problems/bi-upstream-refused
bi_upstream_unavailable

500 · 无法连接到 BI 系统

类型:https://screenrig.ai/problems/bi-upstream-unavailable
bi_web_unavailable

409 · 此服务器没有页面渲染器

类型:https://screenrig.ai/problems/bi-web-unavailable
schedule_import_invalid

422 · 导入含有错误行

类型:https://screenrig.ai/problems/schedule-import-invalid
schedule_import_stale

409 · 项目自预览后已更改

类型:https://screenrig.ai/problems/schedule-import-stale
campaign_limit_reached

409 · 组织已达到最大活动数量

type: https://screenrig.ai/problems/campaign-limit-reached
kv_webhook_limit_reached

409 · 应用已达到最大键值 webhook 数量

类型:https://screenrig.ai/problems/kv-webhook-limit-reached
support_conversation_closed

409 · 支持对话已关闭

类型:https://screenrig.ai/problems/support-conversation-closed
submission_too_short

422 · 提交内容过短无法处理

类型:https://screenrig.ai/problems/submission-too-short
submission_unclear

422 · 提交未描述问题或请求

类型:https://screenrig.ai/problems/submission-unclear
submission_rejected

422 · 提交未被接受

类型:https://screenrig.ai/problems/submission-rejected
submission_screening_unavailable

500 · 当前无法筛查提交内容

类型:https://screenrig.ai/problems/submission-screening-unavailable
demo_slot_unavailable

409 · 演示时间不再可用

类型:https://screenrig.ai/problems/demo-slot-unavailable
agentid_claim_invalid

400 · AgentID 声明无效或已过期

类型:https://screenrig.ai/problems/agentid-claim-invalid
agentid_already_enrolled

409 · AgentID 已注册

类型:https://screenrig.ai/problems/agentid-already-enrolled
account_exists

409 · 此电子邮件已有 screenRIG 账户

类型:https://screenrig.ai/problems/account-exists
email_verification_required

403 · 验证你的电子邮件以继续

类型:https://screenrig.ai/problems/email-verification-required
unverified_account_replacement

409 · 此重置会创建一个新的空账户

类型:https://screenrig.ai/problems/unverified-account-replacement
app_store_transaction_invalid

422 · 无法验证 App Store 购买

类型:https://screenrig.ai/problems/app-store-transaction-invalid
app_store_account_mismatch

409 · 该购买属于另一个组织

类型:https://screenrig.ai/problems/app-store-account-mismatch
education_not_eligible

403 · 组织不符合 Education 套餐的条件

类型:https://screenrig.ai/problems/education-not-eligible
app_store_plan_conflict

409 · 组织已拥有套餐

类型:https://screenrig.ai/problems/app-store-plan-conflict

诊断和合同源

捆绑的 CLI 诊断保持授权、Cookie、签名上传详情、对象标识符和客户内容不出现在保留输出中。原始 OpenAPI 文档是 HTTP 的真实来源。

架构索引

生成名称、必填字段和模式描述;完整 JSON Schema 请使用原始 OpenAPI。