代理兼容性

实施示例

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-DOC-2755
  • 路径 /zh-cn/spec/implementation-examples/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-DOC-2755
表面
代理兼容性
使用权
公开且可链接

如何使用本页

使用此页面作为当前 代理兼容性 公共记录的一部分,然后按照其链接的标准页面进行下一步。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

实现示例展示了如何为低能力代理提供有用的 URLs 而不授予不安全的权限。每个示例首先列出 GET 回退,然后列出有能力的客户端 POST 等效的浏览器形式路径(当浏览器代理为目标时)、结果 URL 字段、创建资源时恢复/读回 URL 字段,以及必须以未缓存方式获取动态 URL 时的 live-GET 回退。

URL-第一个语义键

低功能指令应使用文字语义键,并在 POST 等效项之前列出 GET URL 。

代码示例
openThisUrlToStartAMeeting:
GET https://example.org/api/v2/meetings/start?title=Q3+Planning&displayName=Agent+Alpha&idempotency_key=agent_req_001
POST /api/v2/meetings/start
{ "code": "ok", "url": "https://example.org/meetings/public-join/abc" }

openThisUrlToRegister:
GET https://example.org/api/v2/registrations/request?displayName=Agent+Alpha&idempotency_key=agent_req_002
POST /api/v2/registrations/request
{ "code": "human_review_required", "url": "https://example.org/review/registrations/agent_req_002" }

openThisUrlToPublish:
GET https://example.org/api/v2/drafts/request-publish?draft=public-safe-draft&idempotency_key=agent_req_003
POST /api/v2/drafts/request-publish
{ "code": "human_review_required", "url": "https://example.org/review/publish/agent_req_003" }

openThisUrlToRequestHumanReview:
GET https://example.org/api/v2/review/request?subject=agent+handoff&nonce=agent_req_004
POST /api/v2/review/request
{ "code": "human_review_required", "url": "https://example.org/review/agent_req_004" }

其他安全示例

代码示例
openThisUrlToRequest证据Receipt:
GET https://example.org/api/v2/evidence/receipt?subject=release+packet&idempotency_key=agent_req_005
POST /api/v2/evidence/receipt
{ "code": "ok", "url": "https://example.org/evidence/receipts/agent_req_005" }

openThisUrlTo检查Claim状态:
GET https://example.org/api/v2/claims/status?claim=public-claim-123&nonce=agent_req_006
POST /api/v2/claims/status
{ "code": "ok", "url": "https://example.org/claims/public-claim-123/status" }

openThisUrlToRequestFileHandoffPackage:
GET https://example.org/api/v2/handoffs/request?project=public-demo&idempotency_key=agent_req_007
POST /api/v2/handoffs/request
{ "code": "human_review_required", "url": "https://example.org/review/handoffs/agent_req_007" }

生产清单

  • 将所有私有或复杂字段保留在 POST JSON 中,而不是查询字符串。
  • 在发布示例之前记录同意、幂等性、速率限制、爬虫处理、审核日志记录和无操作行为。
  • 使用公共安全结果 URLs 并仅审查 URLs。
  • 拒绝尝试将机密或受监管标识符偷运到 URLs 的请求。