Consultar el archivo desde el software

check_coverage

check_coverage(domain)

Si este archivo observa un dominio, desde qué día sellado, qué archivos legibles por máquinas solicita y con qué frecuencia. Admite una URL pegada y la reduce al nombre de dominio.

Una respuesta negativa es una afirmación sobre este archivo, no sobre el dominio: la mayor parte de la web no está observada. Una respuesta afirmativa no dice nada sobre lo que contienen los archivos observados.

suggest_domain

suggest_domain(domain, email, reason)

Propone que se observe un dominio. La respuesta es siempre received con guarantee: none. Es una solicitud, no una instrucción; véase más abajo qué hace y qué no hace una propuesta.

El registro de raíces completo

GET /log.json

Cada día sellado, ambos testigos, en un solo documento: el número de observaciones, la raíz de Merkle, la hora exacta del sellado y qué anclajes externos lleva ese día. Es la forma legible por máquinas del registro público: sin clave, sin paginación, sin límite de frecuencia.

$ curl -s https://machinewitness.eu/log.json | jq '.days[0]'
{
  "day": "2026-08-23",
  "url": "https://machinewitness.eu/log/2026-08-23",
  "witnesses": {
    "witness-1": {
      "sealed": true,
      "observations": 645785,
      "merkle_root": "a86d011c...",
      "anchors": {"opentimestamps": true, "rfc3161": true, "qualified_eidas": true}
    },
    "witness-2": { "sealed": true, "observations": 608542, "merkle_root": "eb3e7e97..." }
  }
}

Los dos testigos sellan de forma independiente, de modo que sus raíces difieren por construcción y nunca se presentan como coincidentes. Un testigo sin sello para un día lo dice expresamente ("sealed": false con un motivo) en lugar de omitirse: una línea ausente no debe leerse nunca como «no procede». Este documento declara lo que se selló, nunca lo que sirvió un dominio.

¿Está observado un dominio?

GET /coverage/{sha256(domain)}

La clave es el SHA-256 hexadecimal en minúsculas del nombre de dominio desnudo: sin esquema, sin www., sin punto final. Usted calcula el hash del nombre, de modo que nunca se transmite y nunca aparece en un registro. Es deliberado: un testigo neutral no debería acumular un registro de quién pregunta por quién.

$ printf 'example.eu' | shasum -a 256
5a9f...  -

$ curl https://machinewitness.eu/coverage/5a9f...
{"observed": false}

Un dominio observado responde con las fechas selladas, los artefactos solicitados y el anillo que determina la cadencia:

{
  "observed": true,
  "first_sealed_observation": "2026-07-29",
  "last_sealed_observation": "2026-08-02",
  "artefacts": ["robots.txt", "ai.txt", "tdmrep.json", "llms.txt", "homepage"],
  "ring": "core",
  "active": true
}

Un dominio que ya no se observa responde "active": false. Sus registros sellados del periodo mostrado se mantienen: un archivo no deja de haber observado el pasado.

Proponer un dominio

POST /request

$ curl -X POST https://machinewitness.eu/request \
    -H 'content-type: application/json' \
    -d '{"domain": "example.eu",
         "email": "you@example.eu",
         "reason": "Why this domain should be observed."}'

{"status": "received",
 "guarantee": "none",
 "domain": "example.eu",
 "detail": "Recorded for review against documented criteria. ..."}

Los tres campos son obligatorios. Una propuesta rechazada responde "status": "rejected" con un motivo: un nombre de dominio inservible, una dirección de respuesta ausente, o un motivo demasiado breve para leerse como tal.

order_capture · POST /order/capture

order_capture(addresses, language, email, timezone)

$ curl -X POST https://machinewitness.eu/order/capture \
    -H 'content-type: application/json' \
    -d '{"addresses": ["https://example.eu/terms"],
         "language": "en",
         "email": "you@example.eu",
         "timezone": "Europe/Berlin"}'

{"status": "ok",
 "reference": "MW-K-3F9A2C1D",
 "checkout_url": "https://checkout.stripe.com/...",
 "expected_start": "2026-10-02T09:02:00.000Z",
 "delivery_notice": "...",
 "status_url": "https://machinewitness.eu/order/capture/MW-K-3F9A2C1D"}

{"status": "precheck_failed",
 "refused": [{"address": "https://example.eu/account",
              "reason": "login", "detail": "This address asks for a login."}],
 "detail": "..."}

Hasta veinte direcciones de un mismo dominio. language es en, de, es, fr, it o pl y fija la página de pago y los correos; email rellena de antemano la página de pago; timezone (IANA, por ejemplo Europe/Madrid, valor por defecto) es la zona en la que delivery_notice indica la hora. expected_start es el inicio prometido antes del pago (UTC): ahora si los testigos están libres, si no el final de su trabajo diario más un margen; null si no han dado estimación. Después de las 21:30 UTC no empieza ninguna captura; un encargo posterior empieza en la primera ventana libre del día siguiente.

capture_status · GET /order/capture/{reference}

capture_status(reference)

$ curl https://machinewitness.eu/order/capture/MW-K-3F9A2C1D

{"reference": "MW-K-3F9A2C1D",
 "status": "first_delivery_sent",
 "addresses": 1,
 "capture_day": "2026-10-02",
 "witnesses": {"witness-1": "captured", "witness-2": "captured"},
 "first_delivery_at": "2026-10-02T09:14:03Z",
 "complete_delivery_at": null}

En qué punto está un encargo, en conjunto y por testigo: pendiente de pago, en cola, capturando, primera entrega enviada, completado. Nunca devuelve la dirección de correo, las direcciones encargadas ni ningún otro dato del cliente.