Odpytywanie archiwum z poziomu oprogramowania

check_coverage

check_coverage(domain)

Czy to archiwum obserwuje domenę, od którego opieczętowanego dnia, o które czytelne dla maszyn pliki pyta i jak często. Wklejony adres URL jest przyjmowany i sprowadzany do nazwy domeny.

Odpowiedź przecząca jest stwierdzeniem o tym archiwum, a nie o domenie: większość sieci nie jest obserwowana. Odpowiedź twierdząca nie mówi nic o tym, co obserwowane pliki zawierają.

suggest_domain

suggest_domain(domain, email, reason)

Zaproponowanie, aby domena była obserwowana. Odpowiedź brzmi zawsze received z guarantee: none. To wniosek, nie polecenie. Zob. niżej, co propozycja daje, a czego nie.

Cały rejestr korzeni

GET /log.json

Każdy opieczętowany dzień, obaj świadkowie, w jednym dokumencie: liczba obserwacji, korzeń Merkle, dokładna godzina opieczętowania oraz to, które zakotwiczenia zewnętrzne dany dzień nosi. To czytelna dla maszyn postać rejestru publicznego: bez klucza, bez stronicowania, bez limitu częstotliwości.

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

Obaj świadkowie pieczętują niezależnie, ich korzenie różnią się więc z samej konstrukcji i nigdy nie są przedstawiane jako zgodne. Świadek, który nie ma pieczęci dla danego dnia, mówi to wprost ("sealed": false z uzasadnieniem), zamiast zostać pominięty. Brakujący wiersz nigdy nie może być czytany jako „nie dotyczy". Ten dokument stwierdza, co zostało opieczętowane, nigdy zaś, co domena wysłała.

Czy domena jest obserwowana?

GET /coverage/{sha256(domain)}

Kluczem jest skrót SHA-256 samej nazwy domeny, zapisany małymi literami szesnastkowo: bez schematu, bez www., bez kropki na końcu. Skrót obliczają Państwo sami, nazwa nie jest więc nigdy przesyłana i nie pojawia się w żadnym dzienniku. To celowe: neutralny świadek nie powinien gromadzić zapisu tego, kto o kogo pytał.

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

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

Obserwowana domena odpowiada opieczętowanymi datami, żądanymi zasobami oraz pierścieniem wyznaczającym częstotliwość:

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

Domena, która nie jest już obserwowana, odpowiada "active": false. Jej opieczętowane zapisy ze wskazanego okresu pozostają. Archiwum nie odobserwowuje przeszłości.

Zaproponuj domenę

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

Wszystkie trzy pola są obowiązkowe. Odrzucona propozycja odpowiada "status": "rejected" z uzasadnieniem: nienadająca się do użycia nazwa domeny, brak adresu zwrotnego albo uzasadnienie zbyt krótkie, by za takie uchodzić.