Proof of Existence

Nachweis anlegen (Hash als JSON, poe oder write)

Verankert poe/<hash> per name_doi mit dem Node-Wallet. Ist der Hash schon aktiv verankert (confirmed) oder wartet eine Operation im Mempool (pending), antwortet die API mit 409. Ist die Registrierung abgelaufen (expired), ebenfalls mit 409, denn der fruehere Nachweis bleibt in der Kettenhistorie gueltig und eine neue Registrierung fuegt nur einen spaeteren Zeitstempel hinzu und ersetzt Notiz und Inhaber des Namens. Mit reanchor=true wird ein abgelaufener Hash bewusst neu registriert, die Antwort enthaelt dann reanchored_after_expiry:true und das aeltere Feld renewed mit demselben Wert. Der Nachweiszeitpunkt bleibt die erste Verankerung (first_anchored in GET /v1/poe/{hash}).

post/v1/poe

Request

  • Base URL: https://doi-api.sendlabs.de (the document declares no server; this is the origin it was published from)
  • URL: https://doi-api.sendlabs.de/v1/poe
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

hashstring required

SHA-256 der Datei, 64 Hex-Zeichen

filenamestring nullable

Optionaler Dateiname, hoechstens 80 Zeichen (wird oeffentlich im Wert gespeichert)

notestring nullable

Optionale Notiz, hoechstens 160 Zeichen (oeffentlich auf der Kette)

reanchorboolean

Nur fuer abgelaufene Namen: true registriert den Hash bewusst neu. Der fruehere Nachweis bleibt in der Kettenhistorie gueltig, die neue Registrierung fuegt nur einen spaeteren Zeitstempel hinzu und ersetzt Notiz und Inhaber des Namens. Ohne true antwortet die API bei einem abgelaufenen Hash mit 409. Bei aktiven oder wartenden Nachweisen ohne Wirkung (dort immer 409).

Example request

{
  "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.