Für Entwickler

HTTP-API

Die Website ist ein Client einer schlichten HTTP-API — alles, was die Ablagezone tut, können Sie mit curl. Die API ist während der Beta kostenlos, ohne Schlüssel. Rate-Limits: 30 Schreibanfragen pro Minute pro IP, dazu tägliche kostenlose Kontingente (20 Konvertierungen / 3 Sprache / 30 Prüfungen — Fehlversuche werden erstattet). KI-Agenten: verweisen Sie sie auf /skill.md — sie enthält diese ganze Seite in agentenfreundlicher Form.

Authentifizierung & Kontingente

Die API ist ohne jeden Schlüssel offen: Anonyme Aufrufer teilen sich die kostenlose Pro-IP-Stufe (L1). Agenten und Skripte mit mehr Bedarf können einen API-Schlüssel (L2b) nutzen — auf Ihrer Kontoseite erstellen und als Bearer-Token senden; jeder Schlüssel erhält eigene Tageskontingente. Schlüssel werden als SHA-256-Hashes gespeichert, der Klartext wird nur einmal bei der Erstellung angezeigt und taucht nie in Logs auf.

Identität	Konvertierungen/Tag	Sprache/Tag	Dateiprüfungen/Tag
Anonym (pro IP) — L1	20	3	30
API-Schlüssel (pro Schlüssel) — L2b	500	20	300

Kontingente setzen sich um Mitternacht UTC zurück; fehlgeschlagene Konvertierungen werden automatisch erstattet. Schreibzugriffe sind auf 30 Anfragen pro Minute pro IP begrenzt.

# Anonym (L1) — kein Schlüssel nötig
curl -X POST https://liteconvert.cc/api/public/detect -F "file=@document.pdf"

# Mit API-Schlüssel (L2b) — ersetzen Sie sk-… durch Ihren Schlüssel
curl -X POST https://liteconvert.cc/api/public/convert \
  -H "Authorization: Bearer sk-…" \
  -F 'meta={"conversion":"pdf-docx"};type=application/json' \
  -F "file=@document.pdf"

401 INVALID_API_KEY: Es wurde ein Schlüssel als Bearer-Token präsentiert, der die Validierung nicht bestanden hat (ungültig oder widerrufen) — ein präsentierter Schlüssel wird immer abgelehnt, nie auf anonym herabgestuft. Anfragen ohne Schlüssel oder mit einem Authorization-Header, der kein Bearer-Schlüssel ist, zählen einfach gegen das anonyme L1-Kontingent. 429 QUOTA_EXCEEDED: Das Tageskontingent dieser Identität ist aufgebraucht; error.reset_at trägt die genaue Zurücksetzungszeit (Mitternacht UTC).

Mehr Spielraum gewünscht — erstellen Sie auf Ihrer Kontoseite einen API-Schlüssel.

Endpunkte

Methode	Pfad	Beschreibung
POST	/api/public/detect	Eine Datei identifizieren (Multipart-Dateifeld). Synchron, ≤20 s.
POST	/api/public/convert	Eine Konvertierung einreichen (Multipart meta + Datei). Gibt request_id zurück.
GET	/api/public/requests/{id}	Status, Fortschritt und Artefakte einer Anfrage.
GET	/api/public/requests/recent?limit=20	Ihre letzten Konvertierungen auf diesem Gerät (X-Owner-Token-Header, anonym).
GET	/api/public/requests/{id}/artifacts/{name}	302-Weiterleitung zur vorzeichneten Download-URL.
GET	/api/public/requests/{id}/timeline	Menschenlesbare Ereigniskette der Konvertierung.
GET	/api/public/stats	Live-Statistiken zur Erfolgsquote.
GET	/api/public/conversions	Der Konvertierungskatalog (alle unterstützten Paare).
GET	/api/public/catalog	Das Build-Manifest (kanonische Schlüssel mit family/lossy/steps) für Website-Builder.

Eine Datei erkennen

curl -X POST https://liteconvert.cc/api/public/detect -F "file=@document.pdf"

{
  "request_id": "c0af…",
  "status": "succeeded",
  "report": { "declared": "pdf", "detected": "pdf", "match": true,
              "mime": "application/pdf", "confidence": 0.99 }
}

Konvertieren und herunterladen

# 1. Einreichen (URL-Quellen senden meta mit source_url und keinen Dateiteil)
curl -X POST https://liteconvert.cc/api/public/convert \
  -F 'meta={"conversion":"pdf-docx"};type=application/json' \
  -F "file=@document.pdf"
# → 202 { "request_id": "…", "status": "running" }

# 2. Abfragen
curl https://liteconvert.cc/api/public/requests/REQUEST_ID
# → { "status": "succeeded", "artifacts": [{ "name": "docx", "download": "…", … }] }

# 3. Herunterladen (302 zur vorzeichneten URL, 1 h gültig)
curl -L -o result.docx https://liteconvert.cc/api/public/requests/REQUEST_ID/artifacts/docx

Fehlercodes

Status	Code	Bedeutung
401	INVALID_API_KEY	Ein ungültiger Schlüssel wurde präsentiert oder der Schlüssel wurde widerrufen. Der Widerruf wirkt sofort — erstellen Sie auf der Kontoseite einen neuen Schlüssel.
429	QUOTA_EXCEEDED	Tägliches kostenloses Kontingent aufgebraucht (Zurücksetzung um Mitternacht UTC; error.reset_at trägt die genaue Zeit). Fehlgeschlagene Konvertierungen werden automatisch erstattet.
422	UNSUPPORTED_CONVERSION	Das Konvertierungspaar ist nicht im Katalog.
404	ARTIFACT_EXPIRED	Das Ergebnis ist abgelaufen und wurde gelöscht (24 h Aufbewahrung) — konvertieren Sie erneut.
413/422	INTAKE_FAILED	Upload fehlgeschlagen oder 200 MB überschritten.
502	CONVERT_FAILED	Die Engines haben es versucht und konnten diese Datei nicht lesen. Detailcodes (NEEDS_OCR, ENCRYPTED_DOCUMENT, MALFORMED_DOCUMENT) werden im request error.code mit festen Meldungen zurückgegeben.
400	INVALID_SOURCE_URL	source_url fehlt oder ist keine gültige öffentliche http(s)-URL.
400	SOURCE_URL_BLOCKED	Die Quell-URL löst zu einer privaten, Loopback- oder Link-Local-Adresse auf und wurde blockiert (SSRF-Schutz).
502	SOURCE_URL_FETCH_FAILED	Die Quell-URL konnte nicht heruntergeladen werden — offline, Zeitüberschreitung, zu groß oder nicht öffentlich erreichbar.
503	CONVERT_API_UNAVAILABLE	Vorübergehende Störung — in einer Minute erneut versuchen.

Für KI-Agenten

Rufen Sie /skill.md ab — ein in sich geschlossenes Anleitungsblatt mit den obigen Endpunkten, durchgerechneten Beispielen und der Free-Tier-Erklärung. Lesen Sie es bei Unsicherheit erneut; es aktualisiert sich mit der API.