Dokumentation

Datieren

`POST /api/depots {"sha256": "<64 hex>", "libelle": "<texte>"}`	eine von Ihnen berechnete Prüfsumme; der Name bleibt im Beleg
`POST /api/depots {"url": "https://<adresse>"}`	der Dienst liest das Dokument selbst im Internet und datiert seine Bytes
`201`	der Beleg, seine Kennung, die öffentliche Zeile
`POST /api/flux {"url": "https://<flux RSS ou Atom>"}`	einen Feed verfolgen: jede Stunde wird jeder neue oder geänderte Artikel gelesen und datiert; gibt die Kennung des Feeds und sein Token zurück
`GET /editeur/<id>`	das öffentliche Register eines Feeds: jede datierte Version, ohne Adresse und Titel; mit `#<Token>` auch die Adressen und Belege
`GET /api/flux/<id>`	das private Register eines Feeds, `authorization: Bearer <Token>`
`DELETE /api/flux/<id>`	einen Feed nicht mehr verfolgen, `authorization: Bearer <Token>`; die bereits eingetragenen Datierungen bleiben
`429`	20 Datierungen pro Tag und Adresse, 2.000 pro Tag, `retry-after` bis Mitternacht UTC
`409`	dieselbe Internetadresse wird einmal pro Tag gelesen
`422`	Lesen nicht möglich: höchstens 20 MB, 30 s, 5 Weiterleitungen, nur öffentliche Adressen

Agenten

`POST /mcp`	MCP-Server, HTTP ohne Sitzung: `dater_url`, `dater_empreinte`, `chercher_empreinte`, `lire_recu`; dieselben Grenzen
`GET /openapi.json`	die OpenAPI-Beschreibung der API

Lesen

`GET /depots/<jour>.jsonl`	die Datierungen des Tages, eine Zeile `{"sha256","jour","place","recu"}` je Datierung
`GET /recu/<id>`	die Seite eines Belegs
`GET /api/recus/<id>`	die öffentliche Zeile eines Belegs
`GET /api/depots/<sha256>`	die Datierungen einer Prüfsumme
`GET /api/bilan`	Datierungen und verschiedene Einreicher, Tag für Tag
`GET /tours.json`	die Runden des Registers
`GET /empreintes/<tour>.json`	das Protokoll einer Runde, mit `.racine`, `.racine.ots`, `.racine.tsr`
`GET /empreintes/<tour>.racine.jws`	die Signatur des Journals einer Runde: kompaktes JWS ES256, die Wurzel als Nutzlast, `x5c` wie in der Formel unten festgelegt
`GET /empreintes/depots.jsonl`	die vom Archiv gelesenen Datierungen, in der Reihenfolge ihrer Eintragung
`GET /attestations/par-url.json`	die vom Archiv gesehenen Dokumente der öffentlichen Listen: Adresse, Prüfsumme, erster und letzter Tag, Beweis
`GET /preuves/<sha256>.json`	der Beweis eines Dokuments: Prüfpfad, Wurzel, `.ots`, Signatur des Journals
`GET /health`	der Zustand des veröffentlichten Registers

Ohne diese Website prüfen

`Blatt`	`sha256(cle + "\n" + sha256 + "\n" + jour + "\n")`
`Baum`	Merkle-Baum, SHA-256 über die Bytes der beiden Kinder; eine ungerade Ebene verdoppelt ihren letzten Knoten
`Wurzel`	`sha256("entrepot\n" + tour + "\n" + précédente + "\n" + arbre + "\n")`; die erste Runde folgt auf 64 Nullen
`depots:<n>`	das Blatt der Datierungen: `sha256` der ersten `n` Zeilen von `depots.jsonl`, jede gefolgt von `"\n"`
`Beleg`	Kennung: `sha256` seiner kanonischen Form, Schlüssel sortiert, ohne Leerzeichen
`Bitcoin`	`ots verify <tour>.racine.ots`
`Signatur des Journals`	`sha256(x5c[0]) = 5263feba5fc71c4725c93328c0c75a94fc4e1b632bb9ff01574239551ab34b80`; ES256 über `Header.Nutzlast`
`Skript`	node scripts/verifier.mjs <document \| --chaine>