Das Archiv aus Software heraus fragen

check_coverage

check_coverage(domain)

Ob dieses Archiv eine Domain beobachtet, ab welchem versiegelten Tag, welche maschinenlesbaren Dateien es anfragt und wie oft. Eine eingefügte URL wird angenommen und auf den Domainnamen zurückgeführt.

Eine verneinende Antwort ist eine Aussage über dieses Archiv, nicht über die Domain: der größte Teil des Webs wird nicht beobachtet. Eine bejahende Antwort sagt nichts darüber, was die beobachteten Dateien enthalten.

suggest_domain

suggest_domain(domain, email, reason)

Schlägt vor, eine Domain zu beobachten. Die Antwort lautet immer received mit guarantee: none. Es ist eine Anregung, keine Anweisung. Siehe unten was ein Vorschlag bewirkt und was nicht.

Das gesamte Wurzelprotokoll

GET /log.json

Jeder versiegelte Tag, beide Zeugen, in einem Dokument: die Zahl der Beobachtungen, die Merkle-Wurzel, der genaue Siegelzeitpunkt und die externen Anker, die dieser Tag trägt. Es ist die maschinenlesbare Form des öffentlichen Protokolls: ohne Schlüssel, ohne Seitenaufteilung, ohne Mengenbegrenzung.

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

Die beiden Zeugen versiegeln unabhängig voneinander, ihre Wurzeln unterscheiden sich also bauartbedingt und werden nie als übereinstimmend dargestellt. Ein Zeuge ohne Siegel für einen Tag sagt das ausdrücklich ("sealed": false mit Grund), statt weggelassen zu werden. Eine fehlende Zeile darf nie als „trifft nicht zu" gelesen werden. Dieses Dokument sagt, was versiegelt wurde, nie, was eine Domain ausgeliefert hat.

Wird eine Domain beobachtet?

GET /coverage/{sha256(domain)}

Der Schlüssel ist der kleingeschriebene hexadezimale SHA-256 des reinen Domainnamens: ohne Schema, ohne www., ohne abschließenden Punkt. Sie hashen den Namen selbst, er wird also nie übertragen und erscheint in keinem Protokoll. Das ist Absicht: ein neutraler Zeuge sollte keine Aufzeichnung darüber ansammeln, wer sich nach wem erkundigt hat.

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

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

Eine beobachtete Domain antwortet mit den versiegelten Daten, den angefragten Artefakten und dem Ring, der die Kadenz bestimmt:

{
  "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
}

Eine Domain, die nicht mehr beobachtet wird, antwortet mit "active": false. Ihre versiegelten Datensätze aus dem angezeigten Zeitraum bleiben bestehen. Ein Archiv macht das Beobachten der Vergangenheit nicht rückgängig.

Eine Domain vorschlagen

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

Alle drei Felder sind erforderlich. Ein abgelehnter Vorschlag antwortet mit "status": "rejected" und einem Grund: ein unbrauchbarer Domainname, eine fehlende Rückadresse oder eine Begründung, die zu kurz ist, um als solche gelesen zu werden.

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

Bis zu zwanzig Adressen einer Domain. language ist en, de, es, fr, it oder pl und bestimmt Zahlungsseite und E-Mails; email füllt die Zahlungsseite vor; timezone (IANA, etwa Europe/Berlin, Vorgabe Europe/Madrid) ist die Zone, in der delivery_notice die Uhrzeit nennt. expected_start ist der vor der Zahlung zugesagte Beginn (UTC): jetzt, wenn die Zeugen frei sind, sonst das Ende ihrer täglichen Arbeit plus Puffer; null, wenn sie keine Schätzung gemeldet haben. Nach 21:30 UTC beginnt keine Aufnahme mehr; ein späterer Auftrag beginnt im ersten freien Fenster des nächsten Tages.

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}

Wo ein Auftrag steht, insgesamt und je Zeuge: wartet auf Zahlung, eingereiht, Aufnahme läuft, erste Lieferung verschickt, abgeschlossen. Nie die E-Mail-Adresse, die bestellten Adressen oder sonst etwas über den Kunden.