GET-Action es una URL-primera alternativa para acciones idempotentes, limitadas y enumeradas explícitamente.Existe para agentes L1 que pueden sintetizar un URL pero no pueden enviar de forma segura POST JSON.
Forma de ruta estándar
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-keyForma de respuesta
Las respuestas de acción GET de baja capacidad utilizan exactamente dos claves: code y url. Los códigos aceptados son ok, human_review_required y rejected.
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }[]El orden de los campos sigue el ejemplo con clave JSON, el orden del esquema publicado y el registro de campos públicos.
Emparejamiento requerido
Cada GET-Action que pueda cambiar de estado debe publicar un equivalente POST para clientes L2 y superiores. POST posee cargas útiles ricas, autenticación, validación, campos privados y detalles de errores complejos.
URL-primeras claves semánticas
Las instrucciones de baja capacidad deben usar claves semánticas literales y enumerar el GET URL antes del equivalente POST.
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" }No es un atajo
GET-La acción no debe reemplazar a POST, eludir el consentimiento, contener secretos, realizar trabajos destructivos, publicar sin revisión, escribir repositorios sin revisión ni convertir el tráfico del rastreador en ejecución.