Herramientas

Referencia API

Manual ruta por ruta para la superficie UAIX REST en vivo, incluidas las solicitudes iniciales, la exportación OpenAPI y los puntos de entrada de la máquina orientados al validador.

  • Registro UAIX-TOOL-0062
  • Ruta /es-es/tools/api-reference/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado el UAIX como parte del registro de estándares públicos actuales
Código
UAIX-TOOL-0062
Superficie
Herramientas
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta página para inspeccionar las rutas REST en vivo, el documento OpenAPI, las solicitudes de inicio copiables orientadas a la máquina y el intercambio simulado de referencia.

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

Rutas en vivo

CatalogarDescubrimientoKit de adopción JSONOpenAPI JSON

Superficie de la máquina

Comience desde el catálogo, luego pase al kit de adopción, OpenAPI, validación e intercambio simulado en vivo.

Esta página existe para evitar que los implementadores realicen ingeniería inversa en la superficie WordPress REST. Resuelva las rutas en vivo aquí, luego pase al paquete de incorporación, validación, prueba de respuesta simulada, manejo de detalles del problema o ensamblaje del paquete sin adivinar. Los archivos de paquetes .uai generados son registros de transferencia y memoria local, no puntos finales de API ni rutas de aplicación alojadas.

resolver primero

Catálogo y descubrimiento

El catálogo y las rutas de descubrimiento le indican a la automatización cuál es la superficie pública actual antes de realizar cualquier llamada específica de la ruta.

Describir contrato

OpenAPI y solicitudes de inicio

Utilice aquí la exportación en vivo OpenAPI y los patrones de solicitud inicial en lugar de depender de copias de páginas raspadas o notas obsoletas.

Llevar adelante

Adopción, validación y evidencia reutilizable

El inventario de rutas es más importante cuando alimenta el paquete de adopción, una ejecución del validador, una respuesta simulada en vivo o un paquete de conformidad que puede viajar hasta la revisión de la versión.

Límite de búsqueda

HTML páginas explican; JSON rutas ejecutadas

Las rutas de la máquina JSON están marcadas como superficies de ejecución no indexables con una política de caché explícita, por lo que las búsquedas y citas deben preferir las páginas de documentación humana.

HTTP fallas

El problema JSON es el contrato de recuperación.

Los errores de búsqueda de rutas, los cuerpos públicos POST con formato incorrecto, los límites de tamaño corporal y los límites de velocidad devuelven una aplicación/problema+json estilo RFC 9457 con códigos UAIX, orientación de reintento, indicadores de evidencia y enlaces de puerto seguro.

Rutas en vivo

CatalogarInventario de normas públicas vigentes.DescubrimientoManifiesto de ruta orientada a la máquina.Kit de adopción JSONPaquete de incorporación publicado para ejecuciones de primera prueba.OpenAPI JSONExportación en vivo OpenAPI 3.1.ValidarMáquina POST objetivo para verificaciones de conformidad.Intercambio simuladoMáquina POST objetivo para un sobre de respuesta conforme en vivo.Paquete de conformidad JSONPaquete de lanzamiento reutilizable en una sola respuesta.

Camino de prueba

Ruta de prueba respaldada por un validador

Mantenga el orden de lectura pública vinculado a un rastro de evidencia: perfil, esquema, ejemplo, resultado del validador y registro de publicación.

  1. 1Elija un perfil de mensaje.Comience con un perfil UAI-1 publicado y la familia de registros que coincida con el intercambio que necesita demostrar.
  2. 2Compárelo con esquemas y ejemplos.Resuelva el esquema, la entrada del registro y un elemento fijo antes de escribir o mapear su paquete candidato.
  3. 3Ejecute la evidencia del validador.Valide JSON con clave, clave minificada o sin clave con los registros públicos UAI-1 actuales.
  4. 4Adjunte el resultado a los registros de implementación o transferencia.Lleve el resultado exportado al paquete de conformidad, al seguimiento de implementación, al registro de cambios o a la evidencia de transferencia del proyecto.
Llamadas inicialesResolver la superficie viva REST
curl -s https://uaix.org/wp-json/uaix/v1/catalog
curl -s https://uaix.org/wp-json/uaix/v1/discovery
curl -s https://uaix.org/wp-json/uaix/v1/adoption-kit
curl -s https://uaix.org/wp-json/uaix/v1/openapi.json
curl -s -X POST https://uaix.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

Utilice primero el catálogo y las rutas de descubrimiento, luego obtenga el kit de adopción, inspeccione el documento OpenAPI o solicite una respuesta simulada en vivo directamente.

Para qué es esta página

Utilice esta página como manual de cara a la máquina para la superficie activa UAIX REST. Traduce el catálogo actual, el descubrimiento, la hoja de ruta, el esquema, el registro, el ejemplo, el validador, el kit de adopción, OpenAPI, el intercambio simulado y las rutas del paquete de conformidad en una referencia de lanzamiento legible por humanos.

Cuando usarlo

  • Cuando un implementador desea la ruta base exacta y el inventario de rutas no locales REST.
  • Cuando un creador de herramientas necesita solicitudes iniciales, el paquete de adopción, los límites del plan futuro y un documento OpenAPI en lugar de realizar ingeniería inversa en el sitio.
  • Cuando un revisor de lanzamiento quiere verificar que la documentación pública, las rutas orientadas a las máquinas, los límites de la hoja de ruta y la evidencia del validador apuntan al mismo lanzamiento.

Ruta más rápida a través de la superficie viva.

  1. resolver el actual/wp-json/uaix/v1/catalogruta primero.
  2. Obtenga un esquema o ejemplo deEsquemas, Registro, yEjemplos.
  3. Tira lo publicadoKit de adopcióncuando necesita el paquete de incorporación reutilizable más corto.
  4. Enviar una ejecución del validadorValidadoro el frente a la máquina/wp-json/uaix/v1/validateruta.
  5. Utilice elPaquete de conformidadcuando esa ejecución debe viajar como evidencia de liberación más amplia.
  6. Usar/wp-json/uaix/v1/roadmapcuando la automatización también necesita la actual frontera entre el futuro y el trabajo.

Mapa de clases de ruta

  • Rutas de descubrimiento GET:catálogo, descubrimiento, esquemas, registro, registro de campo, ejemplos, enlaces de transporte, canales de confianza, registro de errores, niveles de conformidad, hoja de ruta, OpenAPI, kit de adopción y rutas de paquetes de conformidad publican registros actuales legibles por máquina.
  • Ejecución de rutas POST:Las rutas de validación e intercambio simulado aceptan el candidato JSON y deben tratarse como superficies de ejecución sin tienda, no como páginas de destino rastreables.
  • Rutas de citación humana:Las páginas con prefijo local, como UAI-1, Validador, Kit de adopción, Paquete de conformidad, Hoja de ruta y Registro de cambios, son las páginas que un reclamo público debe citar cuando la prosa, los límites y los próximos pasos son importantes.
  • Descargar formularios:Los paquetes JSON descargables son formularios convenientes de los mismos registros públicos, no de autoridades separadas.

Lo que publica esta pagina

  • Una referencia de cara a la máquina ruta por ruta.
  • Ejemplos de solicitudes iniciales para descubrimiento, búsqueda de perfiles, validación, recuperación de paquetes de incorporación y resolución de hojas de ruta.
  • La exportación actual OpenAPI 3.1 para la superficie REST en vivo.
  • Enlaces directos a las páginas públicas canónicas que explican el mismo registro en prosa.

Llamadas iniciales a nivel de ruta

Utilice los fragmentos públicos a continuación cuando desee el catálogo en vivo, el ejemplo y las llamadas del validador en curl, PowerShell, Python o TypeScript sin realizar ingeniería inversa en la superficie de la ruta.

Client examples

Route-level starter requests in curl, PowerShell, Python, and TypeScript

Use these snippets when you want the live catalog, example, validator, and mock-response calls without reverse-engineering the REST surface.

Starter snippets use the live public routes, not a private SDK or unpublished helper layer.

curl

Plain shell

Fastest raw HTTP path for docs, smoke checks, CI probes, and quick manual review.

Kit de adopción Fetch the published onboarding bundle uai-adoption-kit.json
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalogar Resolve the live route catalog
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/catalog"
Ejemplo Fetch one published starter packet example-record.json
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Validar Submit the packet for a result record validate-request.json
Ejemplo de código
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Intercambio simulado Request one live conforming response mock-exchange-request.json
Ejemplo de código
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

Referencia en vivo frente a la máquina

Utilice la referencia a continuación como fuente pública actual para el diseño de rutas, llamadas iniciales y exportación OpenAPI.

Referencia API

Machine-facing launch surface

Use this reference when you want the live REST contract behind the public UAIX pages. The routes below are the canonical machine-facing entry points for discovery, published records, roadmap boundaries, adoption-kit fetches, validator runs, OpenAPI export, and conformance-pack assembly.

Base path

https://uaix.org/wp-json/uaix/v1

Use the canonical non-locale REST base for automation. Do not treat locale-prefixed page URLs as the machine API root.

Auth posture

Public read, posted validation, posted mock exchange

Discovery and record routes are public read surfaces. The validator and the mock exchange both accept JSON POST payloads for live conformance and response-shape testing.

Published formats

JSON + OpenAPI 3.1

The public surface is JSON-first and now publishes an OpenAPI document for route-level onboarding and tooling generation.

Fastest start

Catalog -> Roadmap -> Adoption kit -> Validate -> Mock

Resolve the catalog, check the future-work boundary, fetch the published onboarding bundle, run one validator check, then hit the live mock exchange before you make support or compatibility claims.

Discovery starter Resolve the current catalog
Ejemplo de código
curl -sS https://uaix.org/wp-json/uaix/v1/catalog
Profile starter Resolve one schema and one example example-record.json
Ejemplo de código
curl -sS https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -sS https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1
Kit de adopción Fetch the published onboarding bundle uai-adoption-kit.json
Ejemplo de código
curl -sS https://uaix.org/wp-json/uaix/v1/adoption-kit -o uai-adoption-kit.json
Hoja de ruta Resolve the forward-plan boundary uai-1-roadmap.json
Ejemplo de código
curl -sS https://uaix.org/wp-json/uaix/v1/roadmap -o uai-1-roadmap.json
Validation starter Submit a candidate message validate-request.json
Ejemplo de código
curl -sS -X POST https://uaix.org/wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json
Reference starter Request one live response envelope mock-exchange-request.json
Ejemplo de código
curl -sS -X POST https://uaix.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json
Example request Validator POST body validate-request.json
Ejemplo de código
{
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX Gateway",
            "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    },
    "normalization_mode": "keyed-json",
    "format": "result"
}
Example response Validator result uai-conformance-result.json
Ejemplo de código
{
    "valid": true,
    "checked_at": "2026-07-28T13:40:03+00:00",
    "profile": "uai.intent.request.v1",
    "current_release": "UAI-1",
    "uai_version": "1.0",
    "schema_route_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
    "registry_route_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
    "issue_count": 0,
    "error_count": 0,
    "warning_count": 0,
    "errors": [],
    "warnings": [],
    "status": "pass",
    "normalization": {
        "mode": "keyed-json",
        "status": "current",
        "supported": true,
        "input_shape": "json-object",
        "normalized": false,
        "registry_release": "UAI-1",
        "registry_release_date": "2026-06-02",
        "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
        "canonicalization": "jcs-compatible-sorted-json",
        "canonical_hash": "sha256:df1471b14bfab5649ab461956640cfe8201aab274f3db190bc621dc195dc2abd",
        "byte_count": 2665
    },
    "conformance_record": {
        "uai_version": "1.0",
        "profile": "uai.conformance.result.v1",
        "message_id": "msg-20260728T134003Z-f4f93080f36a",
        "source": {
            "type": "service",
            "id": "uaix.validator",
            "label": "UAIX Validator",
            "uri": "https://uaix.org/en-us/tools/validator/",
            "did": "did:web:uaix.org",
            "role": "conformance-checker",
            "implementation": "uaix-core-3.188.0"
        },
        "target": {
            "type": "message",
            "id": "msg-2026-04-22-0001",
            "label": "uai.intent.request.v1",
            "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
            "did": "did:web:uaix.org",
            "role": "checked-record",
            "implementation": "uai.intent.request.v1"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-validator-f4f93080f36a",
            "parent_message_id": "msg-2026-04-22-0001",
            "sequence": 2,
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
        },
        "delivery": {
            "mode": "sync",
            "priority": "routine",
            "expires_at": "2026-08-04T13:40:03+00:00",
            "reply_requested": false,
            "ack_required": false
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "validator-record",
            "principal": "did:web:uaix.org",
            "credential_ref": "https://uaix.org/.well-known/uai.json",
            "signature_ref": "https://uaix.org/en-us/tools/validator/",
            "replay_window_id": "rw-conformance-20260728-f4f93080f36a"
        },
        "body": {
            "status": "pass",
            "checked_profile": "uai.intent.request.v1",
            "issues": [],
            "summary": {
                "error_count": 0,
                "warning_count": 0,
                "checked_at": "2026-07-28T13:40:03+00:00"
            },
            "artifacts": {
                "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
                "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
            },
            "target_message_ref": "msg-2026-04-22-0001"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-07-28T13:40:03+00:00",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "uaix.validator",
            "model_id": "model.uaix.validator-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "conformance-export",
                    "actor_id": "uaix.validator",
                    "model_id": "model.uaix.validator-1",
                    "note": "Generated a validator-backed evidence record for the checked message using keyed-json normalization."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:d5c3fef11e65c44dcd91b164df0ce15c03cf39c8b69ced323dcdab8c7da7d07d"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:evidence",
                "purpose": "Links conformance output to the exact public artifacts used during validation.",
                "critical": false
            }
        ]
    },
    "download_filename": "msg-20260728T134003Z-f4f93080f36a.json"
}
Adoption kit manifest Published onboarding bundle entry points uai-adoption-kit-manifest.json
Ejemplo de código
{
    "adoption_kit_url": "https://uaix.org/wp-json/uaix/v1/adoption-kit",
    "download_url": "https://uaix.org/wp-json/uaix/v1/adoption-kit?download=1",
    "current_release": "UAI-1",
    "starter_files": 9,
    "language_starters": 4,
    "first_packet_profile": "uai.intent.request.v1",
    "use": "Fetch the adoption_kit_url for the complete starter files and proof artifacts."
}
模拟交换请求 Reference surface POST body mock-exchange-request.json
Ejemplo de código
{
    "scenario": "accepted-task",
    "format": "exchange",
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX Gateway",
            "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    }
}
模拟交换响应 Reference surface exchange bundle uai-mock-exchange.json
Ejemplo de código
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-07-28T13:40:03+00:00",
    "route_url": "https://uaix.org/wp-json/uaix/v1/mock-exchange",
    "scenario": "accepted-task",
    "http_status": 202,
    "summary": "The reference surface accepted the request and returned a conforming async handoff using `uai.intent.response.v1`.",
    "request": {
        "message": {
            "uai_version": "1.0",
            "profile": "uai.intent.request.v1",
            "message_id": "msg-2026-04-22-0001",
            "source": {
                "type": "agent",
                "id": "agent.alpha",
                "label": "Agent Alpha",
                "uri": "https://agents.alpha.example/runtime",
                "did": "did:web:agents.alpha.example",
                "role": "requesting-agent",
                "implementation": "alpha-runtime-2.4.1"
            },
            "target": {
                "type": "service",
                "id": "uaix.gateway",
                "label": "UAIX Gateway",
                "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
                "did": "did:web:uaix.org",
                "role": "public-record-gateway",
                "implementation": "uaix-core-0.4.0"
            },
            "conversation": {
                "conversation_id": "conv-2026-04-22-uaix-001",
                "turn_id": "turn-001",
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
                "sequence": 1
            },
            "delivery": {
                "mode": "async",
                "priority": "interactive",
                "expires_at": "2026-04-22T16:05:00Z",
                "reply_requested": true,
                "ack_required": true
            },
            "trust": {
                "channel": "credentialed",
                "auth_scheme": "did+vc",
                "principal": "did:web:agents.alpha.example",
                "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
                "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
                "replay_window_id": "rw-2026-04-22-0001",
                "trust_profile": "uai.trust.did-vc-reference.v1",
                "verification_status": "not_verified",
                "credential_status": "not_checked",
                "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
                "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
                "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
                "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
                "verification_checked_at": "2026-04-22T16:00:00Z",
                "verification_expires_at": "2026-04-22T16:05:00Z",
                "assurance_level": "reference_only"
            },
            "body": {
                "intent": "resolve-profile",
                "subject": "uai.task.status.v1",
                "requested_profile": "uai.task.status.v1",
                "parameters": {
                    "include_schema": true,
                    "include_example": true,
                    "include_field_registry": true
                },
                "constraints": [
                    "public-record-only",
                    "trace-linked",
                    "validator-ready"
                ],
                "response_profile": "uai.intent.response.v1"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "parent_trace_id": "trace-root-uaix-2026",
                "issued_at": "2026-04-22T16:00:00Z",
                "log_ref": "urn:uaix:log:2026:0001",
                "agent_id": "agent.alpha",
                "model_id": "model.alpha.reasoner-2",
                "confidence": 0.98,
                "lineage": [
                    {
                        "stage": "request-composition",
                        "actor_id": "agent.alpha",
                        "model_id": "model.alpha.reasoner-2",
                        "note": "Requested the async task-status profile and matching field registry."
                    }
                ]
            },
            "integrity": {
                "version": 2,
                "algorithm": "sha256",
                "canonicalization": "jcs",
                "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:delivery",
                    "purpose": "Explicit async request handling and expiry semantics.",
                    "critical": false
                }
            ]
        },
        "validation": {
            "valid": true,
            "checked_at": "2026-07-28T13:40:03+00:00",
            "profile": "uai.intent.request.v1",
            "current_release": "UAI-1",
            "uai_version": "1.0",
            "schema_route_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_route_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "issue_count": 0,
            "error_count": 0,
            "warning_count": 0,
            "errors": [],
            "warnings": [],
            "status": "pass",
            "normalization": {
                "mode": "keyed-json",
                "status": "current",
                "supported": true,
                "input_shape": "json-object",
                "normalized": false,
                "registry_release": "UAI-1",
                "registry_release_date": "2026-06-02",
                "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "canonicalization": "jcs-compatible-sorted-json",
                "canonical_hash": "sha256:df1471b14bfab5649ab461956640cfe8201aab274f3db190bc621dc195dc2abd",
                "byte_count": 2665
            },
            "conformance_record": {
                "uai_version": "1.0",
                "profile": "uai.conformance.result.v1",
                "message_id": "msg-20260728T134003Z-f4f93080f36a",
                "source": {
                    "type": "service",
                    "id": "uaix.validator",
                    "label": "UAIX Validator",
                    "uri": "https://uaix.org/en-us/tools/validator/",
                    "did": "did:web:uaix.org",
                    "role": "conformance-checker",
                    "implementation": "uaix-core-3.188.0"
                },
                "target": {
                    "type": "message",
                    "id": "msg-2026-04-22-0001",
                    "label": "uai.intent.request.v1",
                    "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                    "did": "did:web:uaix.org",
                    "role": "checked-record",
                    "implementation": "uai.intent.request.v1"
                },
                "conversation": {
                    "conversation_id": "conv-2026-04-22-uaix-001",
                    "turn_id": "turn-validator-f4f93080f36a",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-08-04T13:40:03+00:00",
                    "reply_requested": false,
                    "ack_required": false
                },
                "trust": {
                    "channel": "signed-envelope",
                    "auth_scheme": "validator-record",
                    "principal": "did:web:uaix.org",
                    "credential_ref": "https://uaix.org/.well-known/uai.json",
                    "signature_ref": "https://uaix.org/en-us/tools/validator/",
                    "replay_window_id": "rw-conformance-20260728-f4f93080f36a"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-07-28T13:40:03+00:00"
                    },
                    "artifacts": {
                        "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
                        "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                        "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                        "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                        "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                        "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                        "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                        "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                        "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                        "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
                    },
                    "target_message_ref": "msg-2026-04-22-0001"
                },
                "provenance": {
                    "trace_id": "trace-7f3a2d",
                    "issued_at": "2026-07-28T13:40:03+00:00",
                    "log_ref": "urn:uaix:log:2026:0001",
                    "agent_id": "uaix.validator",
                    "model_id": "model.uaix.validator-1",
                    "confidence": 1,
                    "lineage": [
                        {
                            "stage": "conformance-export",
                            "actor_id": "uaix.validator",
                            "model_id": "model.uaix.validator-1",
                            "note": "Generated a validator-backed evidence record for the checked message using keyed-json normalization."
                        }
                    ],
                    "parent_trace_id": "trace-7f3a2d"
                },
                "integrity": {
                    "version": 2,
                    "algorithm": "sha256",
                    "canonicalization": "jcs",
                    "checksum": "sha256:d5c3fef11e65c44dcd91b164df0ce15c03cf39c8b69ced323dcdab8c7da7d07d"
                },
                "extensions": [
                    {
                        "namespace": "urn:uaix:ext:evidence",
                        "purpose": "Links conformance output to the exact public artifacts used during validation.",
                        "critical": false
                    }
                ]
            },
            "download_filename": "msg-20260728T134003Z-f4f93080f36a.json"
        }
    },
    "response_profile": "uai.intent.response.v1",
    "response_message": {
        "uai_version": "1.0",
        "profile": "uai.intent.response.v1",
        "message_id": "msg-mock-accepted-597a626a1d45",
        "source": {
            "type": "service",
            "id": "uaix.mock.exchange",
            "label": "UAIX Mock Exchange",
            "uri": "https://uaix.org/wp-json/uaix/v1/mock-exchange",
            "did": "did:web:uaix.org",
            "role": "reference-server",
            "implementation": "uaix-core-3.188.0"
        },
        "target": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-mock-597a626a1d45",
            "parent_message_id": "msg-2026-04-22-0001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01",
            "sequence": 2
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00+00:00",
            "reply_requested": false,
            "ack_required": true,
            "task_ref": "task-mock-597a626a1d45"
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "jws",
            "principal": "did:web:uaix.org",
            "credential_ref": "https://uaix.org/.well-known/uai.json",
            "signature_ref": "https://uaix.org/wp-json/uaix/v1/mock-exchange#signature-597a626a1d45",
            "replay_window_id": "rw-mock-597a626a1d45"
        },
        "body": {
            "status": "accepted",
            "subject": "uai.task.status.v1",
            "request_message_id": "msg-2026-04-22-0001",
            "result": {
                "task_id": "task-mock-597a626a1d45",
                "status_profile": "uai.task.status.v1",
                "status_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1",
                "response_profile": "uai.intent.response.v1",
                "follow_up_scenarios": [
                    "completed-response",
                    "typed-error"
                ],
                "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "mock_exchange_url": "https://uaix.org/wp-json/uaix/v1/mock-exchange"
            },
            "notices": [
                "accepted-task-started",
                "use-task-status-example-for-shape-checks",
                "reference-surface-response"
            ],
            "task_ref": "task-mock-597a626a1d45"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-22T16:00:03+00:00",
            "log_ref": "urn:uaix:log:mock:20260728:597a626a1d45",
            "agent_id": "uaix.mock.exchange",
            "model_id": "model.uaix.mock.exchange-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "mock-acceptance",
                    "actor_id": "uaix.mock.exchange",
                    "model_id": "model.uaix.mock.exchange-1",
                    "note": "Accepted the request and published a deterministic async handoff from the UAIX mock exchange surface."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:2414b52708fa6f402ab1bfda68977b8c9ef1161aeb1b4a217cdbaaaed2425b38"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:mock-exchange",
                "purpose": "Marks this envelope as a deterministic response from the UAIX live reference surface for scenario `accepted-task`.",
                "critical": false
            }
        ]
    },
    "response_validation": {
        "valid": true,
        "checked_at": "2026-07-28T13:40:03+00:00",
        "profile": "uai.intent.response.v1",
        "current_release": "UAI-1",
        "uai_version": "1.0",
        "schema_route_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
        "registry_route_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
        "issue_count": 0,
        "error_count": 0,
        "warning_count": 0,
        "errors": [],
        "warnings": [],
        "status": "pass",
        "normalization": {
            "mode": "keyed-json",
            "status": "current",
            "supported": true,
            "input_shape": "json-object",
            "normalized": false,
            "registry_release": "UAI-1",
            "registry_release_date": "2026-06-02",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:0f7e89e7c20edbc5f1bb0dfeef66e3c8ecf5ab70f284e9ef13e6a425a51a8268",
            "byte_count": 2709
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260728T134003Z-27490df47db4",
            "source": {
                "type": "service",
                "id": "uaix.validator",
                "label": "UAIX Validator",
                "uri": "https://uaix.org/en-us/tools/validator/",
                "did": "did:web:uaix.org",
                "role": "conformance-checker",
                "implementation": "uaix-core-3.188.0"
            },
            "target": {
                "type": "message",
                "id": "msg-mock-accepted-597a626a1d45",
                "label": "uai.intent.response.v1",
                "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                "did": "did:web:uaix.org",
                "role": "checked-record",
                "implementation": "uai.intent.response.v1"
            },
            "conversation": {
                "conversation_id": "conv-2026-04-22-uaix-001",
                "turn_id": "turn-validator-27490df47db4",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-08-04T13:40:03+00:00",
                "reply_requested": false,
                "ack_required": false
            },
            "trust": {
                "channel": "signed-envelope",
                "auth_scheme": "validator-record",
                "principal": "did:web:uaix.org",
                "credential_ref": "https://uaix.org/.well-known/uai.json",
                "signature_ref": "https://uaix.org/en-us/tools/validator/",
                "replay_window_id": "rw-conformance-20260728-27490df47db4"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-07-28T13:40:03+00:00"
                },
                "artifacts": {
                    "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
                    "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
                    "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
                    "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                    "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                    "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                    "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                    "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                    "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                    "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
                },
                "target_message_ref": "msg-mock-accepted-597a626a1d45"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "issued_at": "2026-07-28T13:40:03+00:00",
                "log_ref": "urn:uaix:log:mock:20260728:597a626a1d45",
                "agent_id": "uaix.validator",
                "model_id": "model.uaix.validator-1",
                "confidence": 1,
                "lineage": [
                    {
                        "stage": "conformance-export",
                        "actor_id": "uaix.validator",
                        "model_id": "model.uaix.validator-1",
                        "note": "Generated a validator-backed evidence record for the checked message using keyed-json normalization."
                    }
                ],
                "parent_trace_id": "trace-7f3a2d"
            },
            "integrity": {
                "version": 2,
                "algorithm": "sha256",
                "canonicalization": "jcs",
                "checksum": "sha256:521a24a222e7bfca086a63e5e408ac48145b214d0c38a479486e7115f1c99489"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact public artifacts used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260728T134003Z-27490df47db4.json"
    },
    "links": {
        "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
        "validate_url": "https://uaix.org/wp-json/uaix/v1/validate",
        "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
        "response_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "task_status_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1"
    }
}

Catalogar

/wp-json/uaix/v1/catalog

GET

Resolve the full current route inventory, counts, and public page map before automation starts.

Descubrimiento

/wp-json/uaix/v1/discovery

GET

Read the current release metadata and profile inventory without scraping page HTML.

Esquemas

/wp-json/uaix/v1/schemas

GET

List published schema records for the current UAI-1 profile family.

Registro

/wp-json/uaix/v1/registry

GET

Resolve the stable profile identifiers, status, and linked artifact URLs.

Registro de campos

/wp-json/uaix/v1/field-registry

GET

Keep keyed JSON, keyless transport, and nested body order aligned.

Fijaciones de transporte

/wp-json/uaix/v1/transport-bindings

GET

Review binding IDs, media types, and protocol-fit notes before capability claims.

Canales de confianza

/wp-json/uaix/v1/trust-channels

GET

Review the published trust posture options and related identity controls.

Niveles de conformidad

/wp-json/uaix/v1/conformance-levels

GET

Resolve the public support-claim ladder before using conformance language outwardly.

Registro de errores

/wp-json/uaix/v1/error-registry

GET

Use the published error codes and validator issue codes instead of inventing local failure vocabularies.

Ejemplos

/wp-json/uaix/v1/examples

GET

Fetch the current fixtures that the validator and documentation both rely on.

Validar

/wp-json/uaix/v1/validate

POST

Validate a candidate message and return the conformance record directly when requested.

Kit de adopción

/wp-json/uaix/v1/adoption-kit

GET

Fetch the published onboarding bundle with starter files, proof artifacts, and implementation handoff links.

Hoja de ruta

/wp-json/uaix/v1/roadmap

GET

Resolve the current, next, planned, and research-track roadmap boundary before repeating future support claims.

Mock exchange reference

/wp-json/uaix/v1/mock-exchange

GET

Read supported scenarios, formats, starter calls, and response-shape guidance before posting a candidate packet.

Intercambio simulado

/wp-json/uaix/v1/mock-exchange

POST

Post a published or candidate request and receive a conforming mock response envelope from the live reference surface.

OpenAPI JSON

/wp-json/uaix/v1/openapi.json

GET

Resolve the OpenAPI 3.1 document that describes the current public REST surface.

Paquete de conformidad

/wp-json/uaix/v1/conformance-pack

GET

Fetch the reusable release packet with schemas, registry data, fixtures, and guidance in one JSON bundle.

Machine-route hardening

The machine-facing surface now carries a visible security-header layer

Use this section when checking that the API handbook, validator routes, and the published trust posture agree on the same launch-stage response hardening.

X-Content-Type-Options

nosniff

Prevents content-type sniffing on public standards pages and machine-readable routes.

Applied to: Public HTML, JSON, XML, and similar WordPress-rendered responses.

Referrer-Policy

strict-origin-when-cross-origin

Keeps cross-origin referrer leakage narrower while preserving same-origin debugging context.

Applied to: Public document and API responses that can generate outbound requests.

Permissions-Policy

accelerometer=(), browsing-topics=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=()

Declares that the launch surface does not rely on privileged browser capabilities or Topics-based advertising features.

Applied to: Public WordPress-rendered pages and machine-facing routes.

X-Frame-Options

SAMEORIGIN

Blocks third-party framing while preserving same-origin editorial and preview flows.

Applied to: Public WordPress-rendered pages and JSON responses.

Content-Security-Policy

frame-ancestors 'self'

Makes the framing boundary explicit in modern browsers without claiming a broader full-site CSP yet.

Applied to: Public WordPress-rendered pages and machine-facing routes.

Strict-Transport-Security

max-age=31536000; includeSubDomains

Pins future browser access to HTTPS on the canonical launch host without relying only on policy prose.

Applied to: Public WordPress-rendered HTML and REST responses when the request is served over HTTPS.

Live now

Headers that travel with public machine routes now

  • 已从公开响应中移除回链响应头。
  • Host- or proxy-level version headers still need server-side suppression if the launch environment adds them after WordPress runs.
  • These headers now travel with public WordPress-rendered HTML and REST responses instead of remaining only in roadmap prose.

Deployment gap

Machine-surface tasks that still need deployment validation

  • HTTP-to-HTTPS redirects and HSTS coverage for directly served static files still belong at the launch host or CDN edge because the local Studio environment runs over plain HTTP.
  • Any directly served static root files should be checked at the server or edge layer so their headers stay aligned with the WordPress-rendered trust posture.
  • Host-level version disclosure such as proxy or PHP signature headers should be suppressed where the deployment stack adds them outside WordPress.
  • Broader CSP directives should be added only after production asset and embedding behavior are validated against the launch host.

Scope boundary: The current header layer is applied to public WordPress-rendered front-end and REST responses, including the validator and machine-facing review routes; HSTS is emitted only on HTTPS requests.

Siguiente paso

Continuar aKit de adopciónsi necesitas el paquete publicado de primera prueba,Paquete de conformidadSi necesita el paquete JSON reutilizable más amplio, ábralo/wp-json/uaix/v1/roadmapsi la automatización necesita el límite del trabajo futuro, o volver aValidadorcuando se ejecuta la siguiente tarea o se exporta una verificación de prueba concreta.