Interrogare l'archivio da software

check_coverage

check_coverage(domain)

Se questo archivio osservi un dominio, da quale giornata sigillata, quali file leggibili dalle macchine richieda e con quale frequenza. Un URL incollato viene accettato e ridotto al nome di dominio.

Una risposta negativa è un'affermazione su questo archivio, non sul dominio: la maggior parte del web non è osservata. Una risposta positiva non dice nulla di ciò che i file osservati contengono.

suggest_domain

suggest_domain(domain, email, reason)

Proporre che un dominio venga osservato. La risposta è sempre received con guarantee: none. È una richiesta, non un'istruzione. Si veda più sotto che cosa fa e che cosa non fa una proposta.

L'intero registro delle radici

GET /log.json

Ogni giornata sigillata, entrambi i testimoni, in un solo documento: il numero di osservazioni, la radice di Merkle, l'ora esatta della sigillatura e quali ancoraggi esterni quella giornata porti. È la forma leggibile dalle macchine del registro pubblico: senza chiave, senza paginazione, senza limite di frequenza.

$ 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..." }
  }
}

I due testimoni sigillano in modo indipendente, quindi le loro radici differiscono per costruzione e non sono mai presentate come coincidenti. Un testimone privo di sigillo per una giornata lo dichiara esplicitamente ("sealed": false con una motivazione) anziché essere omesso. Una riga assente non deve mai leggersi come «non applicabile». Questo documento enuncia ciò che è stato sigillato, mai ciò che un dominio ha servito.

Un dominio è osservato?

GET /coverage/{sha256(domain)}

La chiave è l'impronta SHA-256 del nome di dominio nudo, in esadecimale minuscolo: senza schema, senza www., senza punto finale. L'impronta la calcola Lei, cosicché il nome non venga mai trasmesso e non compaia in alcun log. È deliberato: un testimone neutrale non deve accumulare la traccia di chi abbia chiesto di chi.

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

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

Un dominio osservato risponde con le date sigillate, le risorse richieste e l'anello che determina la cadenza:

{
  "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 che non è più osservato risponde "active": false. I suoi record sigillati del periodo indicato restano. Un archivio non dis-osserva il passato.

Proporre 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. ..."}

Tutti e tre i campi sono obbligatori. Una proposta respinta risponde "status": "rejected" con una motivazione: un nome di dominio inutilizzabile, un indirizzo di risposta mancante, o una motivazione troppo breve per essere tale.

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": "..."}

Fino a venti indirizzi di un unico dominio. language è en, de, es, fr, it o pl e stabilisce la pagina di pagamento e le e-mail; email precompila la pagina di pagamento; timezone (IANA, ad esempio Europe/Rome, predefinito Europe/Madrid) è il fuso in cui delivery_notice indica l’ora. expected_start è l’inizio promesso prima del pagamento (UTC): adesso se i testimoni sono liberi, altrimenti la fine del loro lavoro quotidiano più un margine; null se non hanno fornito una stima. Dopo le 21:30 UTC non inizia alcuna acquisizione; un ordine successivo inizia nella prima finestra libera del giorno seguente.

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}

A che punto è un ordine, nel complesso e per testimone: in attesa di pagamento, in coda, acquisizione in corso, prima consegna inviata, completato. Non restituisce mai l’indirizzo e-mail, gli indirizzi ordinati né altro sul cliente.