Outils

Référence API

Manuel itinéraire par itinéraire pour la surface UAIX REST en direct, y compris les demandes de démarrage, l'exportation OpenAPI et les points d'entrée de la machine face au validateur.

  • Dossier UAIX-TOOL-0062
  • Chemin /fr-fr/tools/api-reference/
  • Utilisation Dossier public canonique

Statut du document

Page des normes publiques Publié le UAIX dans le cadre du dossier actuel des normes publiques
Code
UAIX-TOOL-0062
Surface
Outils
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez cette page pour inspecter les itinéraires REST en direct, le document OpenAPI, les demandes de démarrage copiables côté machine et l'échange fictif de référence.

Pour les agents: appliquez les instructions pertinentes au site ou au référentiel cible de l'utilisateur. Ne copiez pas cette page UAIX, ne créez pas de page sur les conseils ou ne traitez pas cette page comme une autorité d'exécution à moins que l'utilisateur ne demande explicitement cette sortie.

Itinéraires en direct

CatalogueDécouverteKit d'adoption JSONOpenAPI JSON

Surface de la machine

Commencez par le catalogue, puis passez au kit d'adoption, OpenAPI, validation et échange simulé en direct

Cette page existe pour empêcher les implémenteurs de faire de l'ingénierie inverse de la surface WordPress REST. Résolvez les itinéraires en direct ici, puis passez au bundle d'intégration, à la validation, aux tests de réponse simulée, à la gestion des détails du problème ou à l'assemblage du pack sans deviner. Les fichiers de package .uai générés sont des enregistrements de mémoire locale et de transfert, et non des points de terminaison d'API ou des routes d'application hébergées.

Résoudre d'abord

Catalogue et découverte

Le catalogue et les itinéraires de découverte indiquent à l'automatisation quelle est la surface publique actuelle avant qu'un appel spécifique à un itinéraire ne soit effectué.

Décrire le contrat

OpenAPI et demandes de démarrage

Utilisez ici l'exportation OpenAPI en direct et les modèles de demande de démarrage au lieu de vous fier à des copies de pages récupérées ou à des notes obsolètes.

Reporter

Adoption, validation et preuves réutilisables

L'inventaire des itinéraires est particulièrement important lorsqu'il alimente le bundle d'adoption, une exécution du validateur, une réponse simulée en direct ou un paquet de conformité qui peut être transmis à la révision de la version.

Limite de recherche

HTML pages expliquent; JSON routes s'exécutent

Les routes JSON de la machine sont marquées comme surfaces d'exécution non indexables avec une politique de cache explicite, donc la recherche et la citation doivent préférer les pages de documentation humaine.

HTTP échecs

Le problème JSON est le contrat de récupération

Les échecs de recherche d'itinéraire, les corps POST publics mal formés, les limites de taille de corps et les limites de débit renvoient une application/un problème de style RFC 9457+json avec des codes UAIX, des conseils de nouvelle tentative, des indicateurs de preuves et des liens de sphère de sécurité.

Itinéraires en direct

CatalogueInventaire actuel des normes publiques.DécouverteManifeste d’itinéraire face à la machine.Kit d'adoption JSONBundle d'intégration publié pour les premières exécutions.OpenAPI JSONExportation en direct OpenAPI 3.1.ValiderMachine POST cible pour les contrôles de conformité.Échange simuléMachine POST cible pour une enveloppe de réponse conforme en direct.Pack de conformité JSONPaquet de lancement réutilisable en une seule réponse.

Chemin de preuve

Chemin de preuve soutenu par le validateur

Gardez l'ordre de lecture publique lié à une seule piste de preuves: profil, schéma, exemple, résultat du validateur et enregistrement de publication.

  1. 1Choisissez un profil de message.Commencez par un profil UAI-1 publié et la famille d'enregistrements qui correspond à l'échange que vous devez prouver.
  2. 2Comparez-le avec des schémas et des exemples.Résolvez le schéma, l'entrée de registre et un appareil avant d'écrire ou de mapper votre dossier de candidat.
  3. 3Exécutez des preuves de validation.Validez les JSON avec clé, à clé minifiée ou sans clé par rapport aux enregistrements publics UAI-1 actuels.
  4. 4Joignez le résultat aux enregistrements d’implémentation ou de transfert.Transportez le résultat exporté dans le pack de conformité, le suivi de mise en œuvre, le journal des modifications ou les preuves de transfert de projet.
Appels de démarrageRésoudre la surface REST en direct
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

Utilisez d'abord le catalogue et les itinéraires de découverte, puis extrayez le kit d'adoption, inspectez le document OpenAPI ou demandez directement une réponse simulée en direct.

À quoi sert cette page

Utilisez cette page comme manuel destiné à la machine pour la surface UAIX REST en direct. Il traduit le catalogue actuel, la découverte, la feuille de route, le schéma, le registre, l’exemple, le validateur, le kit d’adoption, OpenAPI, les itinéraires d’échange simulé et de pack de conformité en une référence de lancement lisible par l’homme.

Quand l’utiliser

  • Lorsqu’un implémenteur souhaite connaître le chemin de base et l’inventaire des routes exacts non régionaux REST.
  • Lorsqu’un créateur d’outils a besoin de demandes de démarrage, du bundle d’adoption, des limites du plan prévisionnel et d’un document OpenAPI au lieu de procéder à une ingénierie inverse du site.
  • Lorsqu’un examinateur de lancement souhaite vérifier que la documentation publique, les itinéraires destinés aux machines, les limites de la feuille de route et les preuves du validateur pointent tous vers la même version.

Itinéraire le plus rapide à travers la surface vivante

  1. Résoudre le courant/wp-json/uaix/v1/catalogitinéraire en premier.
  2. Récupérer un schéma ou un exemple à partir deSchémas, Registre, etExemples.
  3. Tirez le publiéKit d’adoptionlorsque vous avez besoin du paquet d’intégration réutilisable le plus court.
  4. Soumettre un validateurValidateurou le face machine/wp-json/uaix/v1/validateitinéraire.
  5. Utilisez lePaquet de conformitélorsque cette course doit voyager en tant que preuve de diffusion plus large.
  6. Utiliser/wp-json/uaix/v1/roadmaplorsque l’automatisation a également besoin des limites actuelles des travaux futurs.

Carte des classes d’itinéraire

  • Itinéraires de découverte GET:Le catalogue, la découverte, les schémas, le registre, le registre de champs, les exemples, les liaisons de transport, les canaux de confiance, le registre des erreurs, les niveaux de conformité, la feuille de route, OpenAPI, le kit d’adoption et les itinéraires des packs de conformité publient les enregistrements actuels lisibles par machine.
  • Exécution des routes POST:Les routes de validation et d’échange simulé acceptent le candidat JSON et doivent être traitées comme des surfaces d’exécution sans magasin, et non comme des pages de destination explorables.
  • Itinéraires de citation humaine:Les pages préfixées par les paramètres régionaux telles que UAI-1, Validator, Adoption Kit, Conformance Pack, Roadmap et Changelog sont les pages qu’une revendication publique doit citer lorsque la prose, les limites et les prochaines étapes sont importantes.
  • Télécharger les formulaires:Les paquets JSON téléchargeables sont des formulaires pratiques des mêmes archives publiques, et non des autorités distinctes.

Ce que publie cette page

  • Une référence route par route orientée machine.
  • Exemples de requêtes de démarrage pour la découverte, la recherche de profil, la validation, la récupération du bundle d’intégration et la résolution de la feuille de route.
  • Exportation OpenAPI 3.1 actuelle pour la surface REST en direct.
  • Liens directs vers les pages publiques canoniques qui expliquent le même enregistrement en prose.

Appels de démarrage au niveau de la route

Utilisez les extraits publics ci-dessous lorsque vous souhaitez que le catalogue en direct, l’exemple et les appels du validateur dans curl, PowerShell, Python ou TypeScript sans procéder à une ingénierie inverse de la surface de routage.

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 d'adoption Fetch the published onboarding bundle uai-adoption-kit.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalogue Resolve the live route catalog
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/catalog"
Exemple Fetch one published starter packet example-record.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Valider Submit the packet for a result record validate-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Échange simulé Request one live conforming response mock-exchange-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

Référence en direct face à la machine

Utilisez la référence ci-dessous comme source publique actuelle pour la configuration des itinéraires, les appels de démarrage et l’exportation OpenAPI.

Référence 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
Exemple de code
curl -sS https://uaix.org/wp-json/uaix/v1/catalog
Profile starter Resolve one schema and one example example-record.json
Exemple de code
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 d'adoption Fetch the published onboarding bundle uai-adoption-kit.json
Exemple de code
curl -sS https://uaix.org/wp-json/uaix/v1/adoption-kit -o uai-adoption-kit.json
Feuille de route Resolve the forward-plan boundary uai-1-roadmap.json
Exemple de code
curl -sS https://uaix.org/wp-json/uaix/v1/roadmap -o uai-1-roadmap.json
Validation starter Submit a candidate message validate-request.json
Exemple de code
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
Exemple de code
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
Exemple de code
{
    "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
Exemple de code
{
    "valid": true,
    "checked_at": "2026-07-25T23:35:40+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-20260725T233540Z-5b3284b84d08",
        "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-5b3284b84d08",
            "parent_message_id": "msg-2026-04-22-0001",
            "sequence": 2,
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
        },
        "delivery": {
            "mode": "sync",
            "priority": "routine",
            "expires_at": "2026-08-01T23:35:40+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-20260725-5b3284b84d08"
        },
        "body": {
            "status": "pass",
            "checked_profile": "uai.intent.request.v1",
            "issues": [],
            "summary": {
                "error_count": 0,
                "warning_count": 0,
                "checked_at": "2026-07-25T23:35:40+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-25T23:35:40+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-20260725T233540Z-5b3284b84d08.json"
}
Adoption kit manifest Published onboarding bundle entry points uai-adoption-kit-manifest.json
Exemple de code
{
    "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
Exemple de code
{
    "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
Exemple de code
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-07-25T23:35:40+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-25T23:35:40+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-20260725T233540Z-5b3284b84d08",
                "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-5b3284b84d08",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-08-01T23:35:40+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-20260725-5b3284b84d08"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-07-25T23:35:40+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-25T23:35:40+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-20260725T233540Z-5b3284b84d08.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:20260725: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:487d94e70d324b8dccab7f22a4a429fa3f4dc54e6324495eb284d7d435d6da67"
        },
        "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-25T23:35:40+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:a3fa547c02e0d9c9a9a03f7ba14de3cce629666c85aaf3854bb3e533e5846855",
            "byte_count": 2709
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260725T233540Z-774ba8492180",
            "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-774ba8492180",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-08-01T23:35:40+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-20260725-774ba8492180"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-07-25T23:35:40+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-25T23:35:40+00:00",
                "log_ref": "urn:uaix:log:mock:20260725: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:e2a6691c7b988e771c147ca8760187a14c205224699fb68090751d76aa7fe613"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact public artifacts used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260725T233540Z-774ba8492180.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"
    }
}

Catalogue

/wp-json/uaix/v1/catalog

GET

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

Découverte

/wp-json/uaix/v1/discovery

GET

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

Schémas

/wp-json/uaix/v1/schemas

GET

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

Registre

/wp-json/uaix/v1/registry

GET

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

Registre des champs

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

GET

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

Fixations de transport

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

GET

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

Canaux de confiance

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

GET

Review the published trust posture options and related identity controls.

Niveaux de conformité

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

GET

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

Registre des erreurs

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

GET

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

Exemples

/wp-json/uaix/v1/examples

GET

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

Valider

/wp-json/uaix/v1/validate

POST

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

Kit d'adoption

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

GET

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

Feuille de route

/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.

Échange simulé

/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.

Paquet de conformité

/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.

Étape suivante

Continuez àKit d’adoptionsi vous avez besoin du bundle de première épreuve publié,Paquet de conformitési vous avez besoin du paquet JSON réutilisable plus large, ouvrez/wp-json/uaix/v1/roadmapsi l’automatisation a besoin de la limite du travail futur, ou revenir àValidateurlorsque la tâche suivante est en cours d’exécution ou lors de l’exportation d’une vérification concrète.