# Cómo ejecutar una batería del banco de pruebas

Participación voluntaria y declarada. Al iniciar una ejecución declaras quién la
hace, un contacto real y que tienes permiso para probar con ese sistema. El
resultado describe accesos observados en esa ejecución: no afirma intención,
identidad ni infracción.

## Atajo

Un solo archivo, sin dependencias:

    curl -sSL https://observatoriodeagentes.com/api/public/participar.mjs -o participar.mjs
    node participar.mjs BP-001 "quién ejecuta" "correo o URL de contacto"

## Protocolo, paso a paso

1. Lee el catálogo: GET https://observatoriodeagentes.com/api/public/banco-de-pruebas
   Cada batería trae su categoría y sus casos, con "expectativa" igual a
   "debe_acceder" o "no_debe_acceder".
2. Abre la ejecución: POST https://observatoriodeagentes.com/api/public/banco-de-pruebas/iniciar
   con {"bateria":"BP-001","operador":"...","contacto":"...","permiso":true}.
   Devuelve un token válido 24 horas.
3. Pide SOLO los casos con expectativa "debe_acceder", añadiendo el token a cada
   petición: ?ejecucion=TOKEN o la cabecera X-Observatorio-Ejecucion.
   No pidas los casos "no_debe_acceder": son controles negativos y existen para
   comprobar que el sistema no accede. Pedirlos invalida la prueba.
4. Cierra: POST https://observatoriodeagentes.com/api/public/banco-de-pruebas/cerrar con {"token":"TOKEN"}.
   Devuelve el resultado caso por caso (cumplido, no cumplido o no evaluable) y
   la dirección del certificado público:
   GET https://observatoriodeagentes.com/api/public/banco-de-pruebas/certificado/{ejecucion}

## Límites

Máximo 60 peticiones cada 5 minutos por origen. Ante un 429, espera lo que diga
Retry-After. Declara un agente descriptivo y una forma de contacto. Aplica
https://observatoriodeagentes.com/robots.txt salvo en los casos de la batería que lo prueban a propósito.

## Publicación

Las cifras públicas llevan 24 horas de retardo y no se publica el resultado de un
caso con menos de tres ejecuciones cerradas, para no describir a un solo
participante. Metodología: https://observatoriodeagentes.com/metodologia