Especificaciones

Ejemplos de implementación

Caja fuerte concreta URL: primeros ejemplos con POST equivalentes para reuniones, registro, revisión de publicación, revisión humana, recibos de evidencia, estado de reclamo y solicitudes de paquetes de transferencia de archivos.

  • Registro UAIX-DOC-2197
  • Ruta /es-es/spec/implementation-examples/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado en UAIX como parte del registro actual de estándares públicos
Code
UAIX-DOC-2197
Superficie
Especificaciones
Acceso
Público y enlazable

Cómo usar esta página

Use esta página como referencia pública canónica para Ejemplos de implementación y su contenido normativo.

Para agentes: aplique las instrucciones pertinentes al sitio o repositorio de destino del usuario. No copie esta página UAIX, no cree una página sobre las instrucciones ni trate esta página como autoridad de ejecución a menos que el usuario solicite explícitamente ese resultado.

Los ejemplos de implementación muestran cómo dar a los agentes de baja capacidad URLs útiles sin otorgarles una autoridad insegura.Cada ejemplo enumera primero el respaldo GET, luego el equivalente del cliente capaz POST, la ruta del formulario del navegador cuando los agentes del navegador son un objetivo, el campo de resultado URL, el campo de restauración/lectura URL cuando se crea un recurso y el respaldo en vivo GET cuando se debe recuperar un URL dinámico sin caché.

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.

Ejemplo de código
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" }

Ejemplos seguros adicionales

Ejemplo de código
openThisUrlToRequestEvidenceReceipt:
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" }

openThisUrlToCheckClaimStatus:
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" }

Lista de verificación de producción

  • Mantenga todos los campos privados o complejos en POST JSON, no en cadenas de consulta.
  • Documente el consentimiento, la idempotencia, los límites de velocidad, el manejo del rastreador, el registro de auditoría y el comportamiento no operativo antes de publicar ejemplos.
  • Utilice el resultado seguro para el público URLs y revise URLs únicamente.
  • Rechace solicitudes que intenten contrabandear secretos o identificadores regulados a URLs.

Propuestas de arquitectura

UAI-1 v1.0 sigue siendo el contrato publicado actual. Las propuestas con versiones independientes describen intercambios, capacidades, recuperación y conservación de las fuentes.

Son diseños propuestos y ejemplos de referencia locales; no se afirma que existan servicios de ejecución alojados ni interoperabilidad independiente verificada.

La propuesta inglesa es la fuente para la interpretación normativa. Este resumen no constituye una traducción normativa revisada.

Leer las propuestas de arquitectura en inglés · Catálogo de propuestas legible por máquina