Entwickler-Dokumentation

Ainonyme erkennt und anonymisiert personenbezogene Daten in Texten – DSGVO-konform, in Echtzeit und mit Hosting in Deutschland. Diese Seite erklärt, wie du die API in deine Anwendung integrierst.

---

So funktioniert Ainonyme

1. Text senden – Du schickst einen Text an die API.
2. Erkennung – Ainonyme erkennt automatisch sensible Daten wie E-Mail-Adressen, Telefonnummern, Adressen, IBANs, Namen, Kreditkartennummern und medizinische Begriffe.
3. Anonymisierung – Erkannte Daten werden durch Platzhalter ersetzt, z. B. [[EMAIL_1]], [[PHONE_1]].
4. Wiederherstellung – Mit der zurückgegebenen map_id kannst du den Originaltext jederzeit wiederherstellen.

Authentifizierung

Alle API-Aufrufe erfordern einen gültigen API-Key im Header:

X-API-KEY: dein-api-key

Deinen API-Key findest du nach dem Login unter Einstellungen → API.

Endpunkte

Text anonymisieren

POST /api/v1/privacy/anonymize
Content-Type: application/json

{
  "text": "Kontaktiere Max Mustermann unter max@example.com",
  "mode": "standard"
}

Antwort:

{
  "text": "Kontaktiere [[NAME_1]] unter [[EMAIL_1]]",
  "entities": [
    { "original": "Max Mustermann", "replacement": "[[NAME_1]]" },
    { "original": "max@example.com", "replacement": "[[EMAIL_1]]" }
  ],
  "map_id": "map_abc123",
  "applied_rules": ["NAME", "EMAIL"],
  "stats": {
    "entities_found": 2,
    "processing_ms": 12
  }
}

Text wiederherstellen

POST /api/v1/privacy/deanonymize
Content-Type: application/json

{
  "text": "Kontaktiere [[NAME_1]] unter [[EMAIL_1]]",
  "map_id": "map_abc123"
}

Antwort:

{
  "text": "Kontaktiere Max Mustermann unter max@example.com",
  "map_id": "map_abc123",
  "applied_rules": ["NAME", "EMAIL"]
}

Optionale Parameter

Erkannte Kategorien

Quickstart mit cURL

curl -X POST https://ainony.me/api/v1/privacy/anonymize \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: DEIN_KEY" \
  -d '{"text": "Sende die Rechnung an Max Mustermann, max@example.com"}'

Fehlercodes

Limits

• Maximale Textlänge: 20.000 Zeichen
• Rate-Limit: 120 Anfragen pro Minute

---

Fragen? Schreib uns an mail@ainony.me.