API

Metadatenverarbeitung via HTTP

Dieselbe Engine, die unsere Webanwendung antreibt, verfügbar als versionierte HTTP-API. Senden Sie Multipart-Dateien und erhalten Sie strukturierte JSON-Antworten oder die verarbeitete Datei zurück.

Dokumentation lesen API-Schlüssel erhalten

Verfügbare Endpunkte

POST/api/v1/analyzeLiest alle in der Datei vorhandenen Metadatenfelder aus.
POST/api/v1/cleanBereinigt Metadaten und verifiziert das erzeugte Ergebnis.
POST/api/v1/editSchreibt oder löscht einzelne Metadatenfelder.
POST/api/v1/apply-profileWendet ein konsistentes Gerätemetadaten-Profil an.

Maschinenlesbare OpenAPI-Spezifikation: /api/v1/openapi.json

Erste Beispielanfrage

curl -X POST https://your-domain/api/v1/clean \
  -H "Authorization: Bearer nmd_live_..." \
  -F "file=@photo.jpg" \
  -F "mode=full" \
  -F "response=json"

{
  "verified": true,
  "before": { "fields": 31, "removable": 26, "gps": true },
  "after":  { "fields": 5,  "removable": 0,  "gps": false },
  "removed": [ { "key": "camera.make", "label": "Make" } ],
  "notes": [ "The compressed image data was copied unchanged." ]
}

Zugriff und Volumen

API-Zugriff ist ab dem Pro-Tarif verfügbar. Jeder Schlüssel rechnet Anfragen vom monatlichen Kontingent Ihres Tarifs ab, und jede HTTP-Antwort weist in ihren Headern das Restkontingent aus.

API-Kontingente nach Tarif
Tarif	Aufrufe pro Monat	Schlüssel	Maximale Dateigröße
Pro	2.000	3	4.29 MB
Business	50.000	20	4.29 MB
Enterprise	Individuell	Maßgeschneidert	4.29 MB

Konsultieren Sie unsere Preise für den vollständigen Vergleich oder kontaktieren Sie uns für größere Enterprise-Volumen.

Häufig gestellte Fragen

Speichern Sie an die API gesendete Dateien?

Nein. Die Datei existiert ausschließlich im flüchtigen Arbeitsspeicher des Prozesses, der die konkrete Anfrage bearbeitet, und wird unmittelbar mit der Antwort freigegeben. Es wird nichts auf Festplatte geschrieben, sodass keine temporären Dateien existieren oder Aufbewahrungsfristen beachtet werden müssen.

Wie funktioniert die Authentifizierung an der API?

Mittels API-Schlüssel, gesendet im Header „Authorization: Bearer <key>“ oder als „X-API-Key: <key>“. Schlüssel werden nach der Erstellung nur ein einziges Mal angezeigt und ausschließlich als kryptografischer SHA-256-Hash gespeichert.

Was passiert, wenn ich mein monatliches Kontingent überschreite?

Sie erhalten eine HTTP 429-Antwort mit einem maschinenlesbaren Fehlercode, aktuellen Nutzungszählern und einem Retry-After-Header. Erfolgreiche Antworten enthalten X-RateLimit-Remaining, um Kontingentengpässe frühzeitig zu erkennen.

Ist die API versioniert?

Ja. Alle öffentlichen Endpunkte laufen unter /api/v1/, und die Antwortstrukturen sind stabil und berechenbar.

Welche Formate unterstützt die API?

Alle von der Engine unterstützten Formate: Bilder, Videos, Audio und PDF. Für ein Format nicht implementierte Operationen liefern HTTP 422 anstatt stillschweigend fehlzuschlagen.