GET-Action est une première solution de secours URL pour les actions explicitement répertoriées, délimitées et idempotentes.Il existe pour les agents L1 qui peuvent synthétiser un URL mais ne peuvent pas envoyer en toute sécurité POST JSON.
Forme d’itinéraire standard
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-keyForme de réponse
Les réponses d’action GET à faible capacité utilisent exactement deux clés: code et url. Les codes acceptés sont ok, human_review_required et rejected.
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }[]L'ordre des champs suit l'exemple de clé JSON, l'ordre du schéma publié et le registre de champs public.
Appairage requis
Chaque GET-Action qui peut changer d’état doit publier un équivalent POST pour les clients L2 et supérieurs. POST possède des charges utiles riches, une authentification, une validation, des champs privés et des détails d’erreur complexes.
URL-premières clés sémantiques
Les instructions de faible capacité doivent utiliser des clés sémantiques littérales et répertorier le GET URL avant l’équivalent 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" }Pas un raccourci
GET-Action ne doit pas remplacer POST, contourner le consentement, contenir des secrets, effectuer un travail destructeur, publier sans examen, écrire des référentiels sans examen ou transformer le trafic des robots en exécution.