GET-Action 是显式列出的、有界的、幂等操作的 URL-first 后备。它适用于可以合成 URL 但无法安全发送 POST JSON 的 L1 代理。
标准路线形状
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-key响应形状
低能力 GET – 操作响应仅使用两个键：code 和 url。接受的代码为 ok、human_review_required 和 rejected。
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }[]字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。
所需配对
每个可以更改状态的 GET-Action 都应该为 L2 及更高版本的客户端发布等效的 POST 。 POST 拥有丰富的有效负载、身份验证、验证、私有字段和复杂的错误详细信息。
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" }不是捷径
GET – 操作不得取代 POST、绕过同意、携带秘密、执行破坏性工作、未经审查而发布、未经审查而写入存储库或将爬虫程序流量转化为执行。