API-Sandkasten
Hier schicken Sie Anfragen direkt an die API dieses Servers und sehen die rohe Antwort. Jede Anfrage lässt sich als curl-Befehl kopieren. Der Server speichert keine Texte und schreibt keine Inhalte ins Log.
Anfrage
Wird als {"text": …} gesendet. Korrekturen (decisions) im JSON-Modus ergänzen.
Keine Eingabe nötig. Die Antwort nennt den Status und das Zeitlimit je Bereinigung.
curl-Befehl anzeigencurl-Befehl ausblenden
Antwort
Noch nicht gesendet. Die Antwort erscheint hier.
| PLATZHALTER | ORIGINAL | START–END |
|---|
Referenz
Endpunkte
- POST/v1/anonymize
- JSON
{"text": "…", "decisions": […]}, Content-Typeapplication/json - POST/v1/anonymize/file
- Multipart, Feld
file, nur Klartext (UTF-8) - GET/healthz
- Status und Zeitlimit je Bereinigung
Korrekturen decisions
Der Server hat keinen Zustand. Wer korrigieren will, schickt den Originaltext erneut und hängt die Korrekturen an.
- action
maskmaskiert eine Stelle,unmaskhebt eine Markierung auf- start, end
- Offsets in Unicode-Codepoints im Original,
endexklusiv - scope
thisnur diese Stelle,alljedes gleiche Vorkommen- class
- bei
mask:PER,ORG,LOC,SENSITIVEoderOTHER
Antwort
- status
processedfertig,needs_reviewPrüfstellen offen,blockedüberwiegend weder deutsch noch englisch, nicht freigegeben- anonymized_text
- Text mit Platzhaltern wie
[PERSON_1], leer beiblocked - counts
- Anzahl ersetzter Stellen je Klasse
- mentions
- jede Stelle mit
start,end,class,placeholder - findings
- Prüfstellen mit
kind, Position unddetail - languages
- Abschnitte mit
start,endundlanguage:de,enoderother(keine Regeln, Absatz wird gemeldet)
Fehler
Fehler kommen als {"error": "…"}.
- 400
- ungültiges JSON oder ungültige Korrektur
- 413
- Eingabe zu groß
- 415
- falscher Content-Type oder Dateiformat
- 422
- leerer Text oder kein gültiges UTF-8
- 503
- alle Plätze belegt, später erneut versuchen
- 504
- Zeitlimit überschritten