{"openapi":"3.1.0","info":{"title":"Verifile API","version":"1.9.1","description":"\nProof of Existence fuer Dateien und Texte: den SHA-256 eines Dokuments in der Doichain verankern und spaeter\npruefen. Die Datei selbst bleibt immer beim Aufrufer, an die API geht nur der Hash.\n\nDies ist der Nachweis-Ausschnitt der Doichain API. Pruefen (`GET /v1/poe/{hash}`) und das oeffentliche Verankern\n(`POST /v1/poe/public`, Tageskontingent je IP-Adresse) brauchen keinen Schluessel. `POST /v1/poe` und\n`GET /v1/poe/quota` erwarten einen poe- oder write-Schluessel im Header `X-API-Key`.\n\nNotiz und Dateiname eines Nachweises sind dauerhaft oeffentlich, also keine personenbezogenen Daten hineinschreiben.\nEin Nachweis ist mit der ersten Bestaetigung endgueltig (naechster Block, im Mittel zehn Minuten).\n\nAnleitung mit Beispielen: https://verifile.it/developers/ Dieselben Funktionen fuer KI-Agenten (MCP):\nhttps://verifile.it/mcp\n\n**Fehlerformat:** `{\"error\": {\"type\": \"...\", \"code\": n, \"message\": \"...\"}}`\n"},"servers":[{"url":"https://verifile.it/api"}],"paths":{"/v1/poe/{hash}":{"get":{"tags":["Proof of Existence"],"summary":"Nachweis zu einem SHA-256-Hash pruefen","description":"status ist unknown (nie registriert), pending (Operation wartet im Mempool), confirmed (aktiv in der Kette) oder expired (Registrierung abgelaufen, der Nachweis bleibt in der Kettenhistorie gueltig). Die Felder auf oberster Ebene (txid, height, block_time, owner_address, value, expires_in) beschreiben die aktuelle Operation des Namens. first_anchored beschreibt die erste Verankerung vollstaendig mit Block, Blockhash, Zeit, Wert (value, value_json) und Inhaberadresse (owner_address). Sie ist der eigentliche Nachweiszeitpunkt. reregistered_after_expiry ist true, wenn der Name nach einem Ablauf neu registriert wurde, moeglicherweise von jemand anderem. Dann gehoeren Inhaber und Notiz auf oberster Ebene zu dieser spaeteren Registrierung und nicht zum ersten Verankerer, current_registration_start nennt deren Beginn (txid, height, block_time_iso, explorer_tx). Aktualisierungen oder Verlaengerungen durch den Inhaber vor dem Ablauf zaehlen nicht als Neuregistrierung. Ist first_anchored.registrations null, war die Namenshistorie nicht verfuegbar. Dann beschreibt first_anchored die aktuelle Operation, die auch eine spaetere Registrierung sein kann, first_anchored.owner_address ist null und reregistered_after_expiry ist false, weil es nicht bestimmbar ist.","operationId":"poe_get_v1_poe__hash__get","security":[{"ApiKey":[]},{"Bearer":[]},{}],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","description":"SHA-256 der Datei, 64 Hex-Zeichen","title":"Hash"},"description":"SHA-256 der Datei, 64 Hex-Zeichen"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/poe/verify":{"post":{"tags":["Proof of Existence"],"summary":"Nachweis pruefen (Hash als JSON)","description":"Antwort wie GET /v1/poe/{hash}. status ist unknown (nie registriert), pending (Operation wartet im Mempool), confirmed (aktiv in der Kette) oder expired (Registrierung abgelaufen, der Nachweis bleibt in der Kettenhistorie gueltig). Die Felder auf oberster Ebene (txid, height, block_time, owner_address, value, expires_in) beschreiben die aktuelle Operation des Namens. first_anchored beschreibt die erste Verankerung vollstaendig mit Block, Blockhash, Zeit, Wert (value, value_json) und Inhaberadresse (owner_address). Sie ist der eigentliche Nachweiszeitpunkt. reregistered_after_expiry ist true, wenn der Name nach einem Ablauf neu registriert wurde, moeglicherweise von jemand anderem. Dann gehoeren Inhaber und Notiz auf oberster Ebene zu dieser spaeteren Registrierung und nicht zum ersten Verankerer, current_registration_start nennt deren Beginn (txid, height, block_time_iso, explorer_tx). Aktualisierungen oder Verlaengerungen durch den Inhaber vor dem Ablauf zaehlen nicht als Neuregistrierung. Ist first_anchored.registrations null, war die Namenshistorie nicht verfuegbar. Dann beschreibt first_anchored die aktuelle Operation, die auch eine spaetere Registrierung sein kann, first_anchored.owner_address ist null und reregistered_after_expiry ist false, weil es nicht bestimmbar ist.","operationId":"poe_verify_v1_poe_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoeVerify"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]},{"Bearer":[]},{}]}},"/v1/poe/public":{"post":{"tags":["Proof of Existence"],"summary":"Nachweis anlegen ohne API-Key (IP-basiertes Tageskontingent)","description":"Oeffentlicher Endpunkt ohne Authentifizierung. Kontingent je IP-Adresse und Tag, Standardmaessig 3 je IP und 50 insgesamt. Der Zaehler ist eigenstaendig, Nachweise mit poe-Schluessel (Verifile, MCP-Server) belasten ihn nicht und umgekehrt. Neuregistrierung (reanchor) ist hier nicht moeglich.","operationId":"poe_public_create_v1_poe_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoePublicCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/poe/public/quota":{"get":{"tags":["Proof of Existence"],"summary":"Verbleibendes Tageskontingent des oeffentlichen Endpunkts (ohne Schluessel)","operationId":"poe_public_quota_v1_poe_public_quota_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/poe":{"post":{"tags":["Proof of Existence"],"summary":"Nachweis anlegen (Hash als JSON, poe oder write)","description":"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}).","operationId":"poe_create_v1_poe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoeCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]},{"Bearer":[]}]}},"/v1/poe/quota":{"get":{"tags":["Proof of Existence"],"summary":"Verbleibendes Tageskontingent eines poe-Schluessels","description":"Mit write- oder admin-Schluessel gibt es kein Kontingent, dann steht unlimited:true. key_id ist der Fingerprint des Schluessels (erste 16 Hexzeichen seines SHA-256), mit dem der Betreiber in DOI_POE_KEY_LIMITS ein eigenes Tageskontingent je Schluessel einstellen kann. Dann steht scope:key und das Kontingent gilt unabhaengig von der IP-Adresse, sonst scope:ip mit dem Kontingent der oeffentlichen App je IP-Adresse.","operationId":"poe_quota_v1_poe_quota_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]},{"Bearer":[]}]}},"/v1/status":{"get":{"tags":["Status"],"summary":"Gesamtstatus von Node, Kette, Fork-Pruefung, ElectrumX und Wallet","description":"Der Wallet-Block mit Guthaben erscheint nur mit write- oder admin-Schluessel, anonyme Aufrufer sehen nur, ob das Wallet Guthaben hat.","operationId":"status_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Eingabe fehlerhaft oder von der Node abgelehnt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Schluessel fehlt oder ist ungueltig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Node-Wallet ohne Guthaben (nur schreibende Aufrufe)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Schluesselstufe reicht nicht oder Methode gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Name, Block, Transaktion oder Pfad nicht vorhanden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"HTTP-Methode fuer diesen Pfad nicht erlaubt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"JSON-Body oder Parameter passen nicht zum Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"423":{"description":"Wallet gesperrt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Ratenbegrenzung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Interner Fehler der API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Node oder ElectrumX nicht erreichbar oder noch nicht synchron","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Zeitueberschreitung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]},{"Bearer":[]},{}]}}},"components":{"schemas":{"ErrorDetail":{"properties":{"type":{"type":"string","title":"Type","description":"rpc, http, validation, node, electrum oder internal"},"code":{"type":"integer","title":"Code","description":"HTTP-Status oder, bei type=rpc, der Fehlercode der Node"},"message":{"type":"string","title":"Message"}},"type":"object","required":["type","code","message"],"title":"ErrorDetail"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}},"type":"object","required":["error"],"title":"ErrorResponse"},"PoeCreate":{"properties":{"hash":{"type":"string","title":"Hash","description":"SHA-256 der Datei, 64 Hex-Zeichen","examples":["e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"]},"filename":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Filename","description":"Optionaler Dateiname, hoechstens 80 Zeichen (wird oeffentlich im Wert gespeichert)"},"note":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Note","description":"Optionale Notiz, hoechstens 160 Zeichen (oeffentlich auf der Kette)"},"reanchor":{"type":"boolean","title":"Reanchor","description":"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).","default":false}},"type":"object","required":["hash"],"title":"PoeCreate"},"PoePublicCreate":{"properties":{"hash":{"type":"string","title":"Hash","description":"SHA-256 der Datei, 64 Hex-Zeichen","examples":["e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"]},"filename":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Filename","description":"Optionaler Dateiname, hoechstens 80 Zeichen (wird oeffentlich im Wert gespeichert)"},"note":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Note","description":"Optionale Notiz, hoechstens 160 Zeichen (oeffentlich auf der Kette)"}},"type":"object","required":["hash"],"title":"PoePublicCreate"},"PoeVerify":{"properties":{"hash":{"type":"string","title":"Hash","description":"SHA-256 der Datei, 64 Hex-Zeichen"}},"type":"object","required":["hash"],"title":"PoeVerify"}},"securitySchemes":{"ApiKey":{"type":"apiKey","description":"API-Schluessel der Stufe poe, write oder admin (Lesen geht ohne Schluessel, solange DOI_PUBLIC_READ=true)","in":"header","name":"X-API-Key"},"Bearer":{"type":"http","description":"Alternativ derselbe Schluessel als Authorization: Bearer <schluessel>","scheme":"bearer"}}},"tags":[{"name":"Status","description":"Zustand von Node, Kette und Hilfsdiensten"},{"name":"Proof of Existence","description":"Dokument-Hashes als Namen verankern und pruefen"}]}