El escaneo de preparación para agentes comprueba por HTTPS lo preparado que está un nombre para agentes IA (reglas IA de robots.txt y Content-Signal, sitemap, llms.txt, markdown, datos estructurados…) y guarda el resultado.
| Operación | Ruta |
|---|---|
| Ver la preparación para agentes | GET /v1/orgs/{org}/zones/{zone}/agent-readiness |
| Escanear la preparación para agentes | POST /v1/orgs/{org}/zones/{zone}/agent-readiness/scan |
Ver la preparación para agentes
GET /v1/orgs/{org}/zones/{zone}/agent-readinessDevuelve el último escaneo de preparación para agentes de un nombre de la zona (404 si no hay). Sin host, el más reciente de cualquier nombre.
Rol necesario: readonly o superior.
Parámetros
| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
org | ruta | string (uuid) | Sí | Id de la organización. Cada ruta comprueba que es la del token (si no, 404). |
zone | ruta | string (uuid) | Sí | Id de la zona (consulta Listar zonas). |
host | consulta | string | No | Un nombre de la zona; sin él, el escaneo más reciente de cualquiera. |
Respuesta
200: Devuelve AgentReadiness.
| Campo | Tipo | Descripción |
|---|---|---|
host | string | |
scanned_at | string (date-time) | |
score | integer | De 0 a 100. |
verdict | string | |
levels | array de object | |
levels[].id | string | Id. |
levels[].passed | integer | |
levels[].total | integer | |
levels[].checks | array de object |
Errores
| Estado | Descripción |
|---|---|
400 | Petición mal formada (bad_request). |
404 | No existe o el token no lo ve (not_found). |
Ejemplo
curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/agent-readiness?host=www.example.com" \
-H "Authorization: Bearer $OPENWAF_TOKEN"import { OpenWAF } from "./openwaf";
const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.getAgentReadiness({
zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
host: "www.example.com"
});from openwaf import OpenWAF
owf = OpenWAF(base_url="https://dash.openwaf.dev") # token de OPENWAF_TOKEN
result = owf.get_agent_readiness(zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d", host="www.example.com")200
{
"host": "www.example.com",
"scanned_at": "2026-10-27T09:30:00Z",
"score": 0,
"verdict": "example",
"levels": [
{
"id": "example",
"passed": 0,
"total": 128,
"checks": [
{}
]
}
]
}Escanear la preparación para agentes
POST /v1/orgs/{org}/zones/{zone}/agent-readiness/scanEscanea ahora un nombre de la zona por HTTPS y guarda el resultado. El nombre se resuelve y solo se contactan direcciones públicas, con límites de tiempo y de tamaño. Una vez por nombre y minuto.
Rol necesario: tech o superior.
Parámetros
| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
org | ruta | string (uuid) | Sí | Id de la organización. Cada ruta comprueba que es la del token (si no, 404). |
zone | ruta | string (uuid) | Sí | Id de la zona (consulta Listar zonas). |
Cuerpo de la petición
Tipo de contenido application/json. El cuerpo es opcional.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
host | string | No | Por defecto el ápice de la zona. |
Respuesta
200: Devuelve AgentReadiness.
| Campo | Tipo | Descripción |
|---|---|---|
host | string | |
scanned_at | string (date-time) | |
score | integer | De 0 a 100. |
verdict | string | |
levels | array de object | |
levels[].id | string | Id. |
levels[].passed | integer | |
levels[].total | integer | |
levels[].checks | array de object |
Errores
| Estado | Descripción |
|---|---|
400 | Petición mal formada (bad_request). |
403 | El rol o los límites del token no lo permiten (forbidden). |
404 | No existe o el token no lo ve (not_found). |
429 | Demasiadas peticiones (rate_limited); espera los segundos de Retry-After. |
503 | No disponible ahora (unavailable); reinténtalo más tarde. |
Ejemplo
curl -X POST "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/agent-readiness/scan" \
-H "Authorization: Bearer $OPENWAF_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"host": "www.example.com"
}'import { OpenWAF } from "./openwaf";
const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.scanAgentReadiness({
zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
body: {
host: "www.example.com"
}
});from openwaf import OpenWAF
owf = OpenWAF(base_url="https://dash.openwaf.dev") # token de OPENWAF_TOKEN
result = owf.scan_agent_readiness(
zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
body={
"host": "www.example.com"
},
)200
{
"host": "www.example.com",
"scanned_at": "2026-10-27T09:30:00Z",
"score": 0,
"verdict": "example",
"levels": [
{
"id": "example",
"passed": 0,
"total": 128,
"checks": [
{}
]
}
]
}