DecoToolkit-API-Dokumentation

Technische Referenz zur programmatischen Nutzung der DecoToolkit-Tools.

Benötigen Sie ein API-Token? Erstellen Sie eines in Ihrem Konto.

Mehr über die DecoToolkit-API-Tarife erfahren

Überblick

Mit der DecoToolkit-API können Sie unsere Tools in Automatisierungen, Workflows und Anwendungen integrieren. Beginnen Sie mit den APIs für QR-Code-Generator, Textbereinigung und JSON-Formatierung – weitere Tools folgen.

Early Access

Die DecoToolkit-API befindet sich derzeit im Early Access. Der erste verfügbare Endpunkt ist der QR-Code-Generator. Weitere Tools werden schrittweise hinzugefügt, während wir die Plattform ausbauen.

Basis-URL

https://api.decotoolkit.com

Authentifizierung

Geschützte Endpunkte erfordern ein Bearer-Token im Authorization-Header.

Authorization: Bearer YOUR_API_TOKEN

Erstellen und verwalten Sie Ihre API-Tokens in Ihrem Konto. Jeder Tarif legt fest, wie viele aktive Tokens Sie halten und wie viele monatliche Credits Sie ausgeben können.

Verfügbare Endpunkte

POST/v1/tools/qr-code

Erzeugen Sie einen QR-Code aus einer URL oder einem Text.

Anfrage-Body

{
  "data": "https://decotoolkit.com",
  "size": 512,
  "format": "svg"
}

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`data`	string	Erforderlich	Der zu kodierende Inhalt. 1 bis 2000 Zeichen.
`size`	number	Optional	Ausgabegröße in Pixel. Min. 128, max. 2048. Standard: 512.
`format`	string	Optional	Ausgabeformat. Derzeit wird nur "svg" unterstützt.

Antwortbeispiel

{
  "success": true,
  "tool": "qr-code",
  "result": {
    "format": "svg",
    "content": "<svg>...</svg>"
  },
  "links": {
    "open_tool": "https://decotoolkit.com/qr-code-generator?utm_source=api&utm_medium=automation&utm_campaign=qr_code",
    "documentation": "https://decotoolkit.com/api/docs"
  },
  "usage": {
    "credits_used": 1
  }
}

cURL-Beispiel

curl -X POST https://api.decotoolkit.com/v1/tools/qr-code \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://decotoolkit.com",
    "size": 512,
    "format": "svg"
  }'

POST/v1/tools/text-cleaner

Bereinigen und normalisieren Sie Text für Automatisierungs-Workflows.

Anfrage-Body

{
  "text": "  Hello   world!\n\nThis is   DecoToolkit.  ",
  "options": {
    "trim": true,
    "removeExtraSpaces": true,
    "removeLineBreaks": false,
    "removeDuplicateLines": false,
    "removeEmptyLines": false
  }
}

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`text`	string	Erforderlich	Der zu bereinigende Textinhalt.
`options`	object	Optional	Bereinigungsoptionen. Alle Optionen sind standardmäßig false, außer trim und removeExtraSpaces.
`options.trim`	boolean	Optional	Entfernt Leerzeichen aus der Endausgabe und jeder erhaltenen Zeile. Standard: true.
`options.removeExtraSpaces`	boolean	Optional	Ersetzt mehrere Leerzeichen und Tabs durch ein einziges Leerzeichen. Standard: true.
`options.removeLineBreaks`	boolean	Optional	Ersetzt Zeilenumbrüche durch Leerzeichen. Standard: false.
`options.removeDuplicateLines`	boolean	Optional	Entfernt doppelte Zeilen und behält das erste Vorkommen bei. Standard: false.
`options.removeEmptyLines`	boolean	Optional	Entfernt leere Zeilen. Standard: false.

Antwortbeispiel

{
  "success": true,
  "tool": "text-cleaner",
  "result": {
    "text": "Hello world!\n\nThis is DecoToolkit.",
    "original_length": 41,
    "cleaned_length": 35,
    "changed": true
  },
  "links": {
    "open_tool": "https://decotoolkit.com/text-cleaner?utm_source=api&utm_medium=automation&utm_campaign=text_cleaner",
    "documentation": "https://decotoolkit.com/api/docs"
  },
  "usage": {
    "credits_used": 1
  }
}

cURL-Beispiel

curl -X POST "https://api.decotoolkit.com/v1/tools/text-cleaner" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "  Hello   world!\n\nThis is   DecoToolkit.  ",
    "options": {
      "trim": true,
      "removeExtraSpaces": true,
      "removeLineBreaks": false,
      "removeDuplicateLines": false,
      "removeEmptyLines": false
    }
  }'

Für n8n: Benutzer können den cURL-Befehl in einen HTTP-Request-Knoten importieren und den Wert von text durch einen dynamischen Ausdruck wie {{$json.text}} ersetzen.

POST/v1/tools/json-formatter

Validieren, formatieren, minifizieren und sortieren Sie JSON in Automatisierungs-Workflows, Skripten, n8n, Zapier, Make und künftigen KI-Agenten.

Anfrage-Body

{
  "json": "{\"name\":\"DecoToolkit\",\"type\":\"API\"}",
  "options": {
    "mode": "format",
    "indent": 2,
    "sortKeys": false
  }
}

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`json`	string	Erforderlich	Der zu verarbeitende JSON-Inhalt. 1 bis 100.000 Zeichen.
`options`	object	Optional	Verarbeitungsoptionen. Alle Optionen haben Standardwerte.
`options.mode`	enum	Optional	Verarbeitungsmodus: "format" \| "minify" \| "validate". Standard: "format".
`options.indent`	number	Optional	Einrückungsebene (0–8). Akzeptiert Zahlen und numerische Zeichenketten zur Kompatibilität mit n8n/Zapier/Make. Standard: 2.
`options.sortKeys`	boolean	Optional	Sortiert Objektschlüssel rekursiv alphabetisch (behält die Array-Reihenfolge bei). Standard: false.

Antwortbeispiel

{
  "success": true,
  "tool": "json-formatter",
  "result": {
    "json": "{\n  \"name\": \"DecoToolkit\",\n  \"type\": \"API\"\n}",
    "valid": true,
    "mode": "format",
    "type": "object",
    "original_length": 39,
    "output_length": 49,
    "changed": true
  },
  "links": {
    "open_tool": "https://decotoolkit.com/json-formatter?utm_source=api&utm_medium=automation&utm_campaign=json_formatter",
    "documentation": "https://decotoolkit.com/api/docs"
  },
  "usage": {
    "credits_used": 1
  }
}

cURL-Beispiel

curl -X POST "https://api.decotoolkit.com/v1/tools/json-formatter" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"name\":\"DecoToolkit\",\"type\":\"API\"}"}'

Für n8n: Benutzer können jedes cURL-Beispiel in einen HTTP-Request-Knoten importieren. Ersetzen Sie nach dem Import YOUR_API_TOKEN durch Ihr API-Token und optional den Wert von json durch einen dynamischen Ausdruck wie {{$json.payload}}.

POST/v1/pdf/extract

Extrahieren Sie sauberen Text, seitenweisen Inhalt, Metadaten und Markdown aus PDF-Dateien. Entwickelt für KI-Workflows, RAG-Pipelines, n8n-Automatisierungen und Datenverarbeitungsskripte.

Anfrage-Body

{
  "fileUrl": "https://beispiel.com/dokument.pdf",
  "mode": "text",
  "includeMetadata": true,
  "cleanText": true,
  "pageRange": { "from": 1, "to": 5 }
}

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`fileUrl`	string	Optional	Öffentliche URL des herunterzuladenden und zu verarbeitenden PDFs. Genau eines der Felder fileUrl oder fileBase64 ist erforderlich.
`fileBase64`	string	Optional	Base64-kodierter PDF-Inhalt. Genau eines der Felder fileBase64 oder fileUrl ist erforderlich.
`mode`	enum	Erforderlich	"text" — vollständiger Text als String. "pages" — Text aufgeteilt nach Seiten. "metadata" — nur Metadaten und Seitenanzahl (1 Credit). "markdown" — einfache Markdown-Ausgabe.
`includeMetadata`	boolean	Optional	Dokumentmetadaten (Titel, Autor, Datum) in der Antwort einschließen. Standard: true.
`cleanText`	boolean	Optional	Leerzeichen normalisieren, übermäßige Leerzeilen entfernen und jede Zeile trimmen. Standard: true.
`pageRange`	object	Optional	Nur eine Teilmenge von Seiten verarbeiten. { from: number, to: number } — beide 1-basiert. Reduziert verbrauchte Credits.

Antwortbeispiel

{
  "success": true,
  "mode": "text",
  "document": {
    "pageCount": 4,
    "title": "Beispieldokument",
    "author": "Autorenname",
    "subject": null,
    "creator": null,
    "producer": null,
    "createdAt": "2024-01-15T14:30:00.000Z",
    "modifiedAt": null
  },
  "text": "Vollständig extrahierter Text aller Seiten...",
  "pages": null,
  "markdown": null,
  "usage": {
    "credits": 4,
    "pagesProcessed": 4
  }
}

cURL-Beispiel

curl -X POST "https://api.decotoolkit.com/v1/pdf/extract" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://beispiel.com/dokument.pdf",
    "mode": "text",
    "cleanText": true
  }'

Für n8n: Verwenden Sie in n8n einen HTTP-Request-Knoten mit der Methode POST und importieren Sie das cURL-Beispiel. Für fileUrl verbinden Sie die Ausgabe eines vorherigen Knotens mit einem Ausdruck wie {{$json.pdfUrl}}. Verbrauchte Credits: 1 pro verarbeiteter Seite für die Modi text/pages/markdown, 1 Credit für den Modus metadata.

POST/v1/pdf/ocr

Extrahieren Sie Text aus gescannten oder bildbasierten PDFs mittels OCR. Verwenden Sie diesen Endpunkt, wenn /v1/pdf/extract keinen Text zurückgibt — zum Beispiel, wenn ein Dokument durch das Scannen physischer Seiten erstellt wurde. OCR verarbeitet jede Seite als Bild und ist daher langsamer und teurer als die normale Textextraktion. Die Genauigkeit hängt von Scanqualität, Auflösung und Sprache ab. Strukturierte Tabellen oder Rechnungsdaten werden nicht extrahiert.

Anfrage-Body

{
  "fileUrl": "https://beispiel.com/gescanntes-dokument.pdf",
  "mode": "text",
  "language": "deu",
  "cleanText": true,
  "pageRange": { "from": 1, "to": 3 }
}

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`fileUrl`	string	Optional	Öffentliche URL des herunterzuladenden und zu verarbeitenden PDFs. Genau eines der Felder fileUrl oder fileBase64 ist erforderlich.
`fileBase64`	string	Optional	Base64-kodierter PDF-Inhalt. Genau eines der Felder fileBase64 oder fileUrl ist erforderlich.
`mode`	enum	Optional	"text" — vollständiger OCR-Text als String (Standard). "pages" — OCR-Text aufgeteilt nach Seiten. "markdown" — einfache Markdown-Ausgabe mit Seitenüberschriften.
`language`	enum	Optional	OCR-Sprachhinweis. Unterstützte Werte: "eng" (Englisch, Standard), "por" (Portugiesisch), "spa" (Spanisch), "fra" (Französisch), "deu" (Deutsch). Verwenden Sie für beste Genauigkeit die Sprache, die dem Dokument entspricht.
`cleanText`	boolean	Optional	Leerzeichen normalisieren, übermäßige Leerzeilen entfernen und jede Zeile trimmen. Standard: true.
`pageRange`	object	Optional	Nur eine Teilmenge von Seiten verarbeiten. { from: number, to: number } — beide 1-basiert. Reduziert verbrauchte Credits. OCR verarbeitet Seiten seriell, daher werden kleinere Bereiche schneller abgeschlossen.

Antwortbeispiel

{
  "success": true,
  "mode": "text",
  "document": {
    "pageCount": 3,
    "title": null
  },
  "text": "Vollständiger OCR-Text aller Seiten...",
  "pages": null,
  "markdown": null,
  "ocr": {
    "provider": "local-tesseract",
    "language": "deu",
    "averageConfidence": null
  },
  "usage": {
    "credits": 15,
    "pagesProcessed": 3
  }
}

cURL-Beispiel

# Gescanntes PDF per URL mit OCR verarbeiten
curl -X POST "https://api.decotoolkit.com/v1/pdf/ocr" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://beispiel.com/gescanntes-dokument.pdf",
    "mode": "text",
    "language": "deu"
  }'

# OCR mit portugiesischer Sprache, nur Seiten 1-2
curl -X POST "https://api.decotoolkit.com/v1/pdf/ocr" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://beispiel.com/relatorio.pdf",
    "mode": "pages",
    "language": "por",
    "pageRange": { "from": 1, "to": 2 }
  }'

# OCR eines Base64-PDFs, Markdown-Ausgabe
curl -X POST "https://api.decotoolkit.com/v1/pdf/ocr" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileBase64": "JVBERi0xLjQK...",
    "mode": "markdown",
    "language": "eng"
  }'

Für n8n: Verwenden Sie in n8n einen HTTP-Request-Knoten mit der Methode POST und importieren Sie das cURL-Beispiel. Verbinden Sie die PDF-URL eines vorherigen Knotens mit einem Ausdruck wie {{$json.pdfUrl}}. Verbrauchte Credits: standardmäßig 5 pro verarbeiteter Seite. OCR ist langsamer als die normale Textextraktion — verwenden Sie pageRange, um Seiten zu begrenzen und so Kosten und Antwortzeit zu reduzieren.

Anwendungsfälle

Verbinden Sie DecoToolkit mit den Tools, die Sie bereits nutzen.

n8n-Workflows

Erzeugen Sie QR-Codes automatisch in n8n-Workflows mithilfe von HTTP-Request-Knoten.

Marketing & Events

Erstellen Sie QR-Codes für Produktseiten, Restaurantmenüs, Events und Marketingkampagnen im großen Maßstab.

Eigene Skripte

Integrieren Sie DecoToolkit in Python, Node.js oder jede Sprache, die HTTP-Anfragen senden kann.

KI-Agenten

Bereiten Sie automatisierte Workflows für KI-Agenten und MCP-kompatible Tools vor.

Mit n8n verwenden

Der schnellste Weg, die DecoToolkit-API mit n8n zu verbinden, ist der Import eines cURL-Befehls in einen HTTP-Request-Knoten.

Schritte

1.Fügen Sie einen HTTP-Request-Knoten hinzu.
2.Klicken Sie auf "Import cURL".
3.Fügen Sie den untenstehenden Befehl ein.
4.Ersetzen Sie YOUR_API_TOKEN durch Ihr DecoToolkit-API-Token.
5.Führen Sie den Knoten aus.

cURL-Beispiel

curl -X POST "https://api.decotoolkit.com/v1/tools/qr-code" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://decotoolkit.com",
    "size": 512,
    "format": "svg"
  }'

Beispiel für dynamische Eingabe

Nach dem Import des cURL-Befehls kann der statische Wert von data durch einen n8n-Ausdruck ersetzt werden:

{{$json.url}}

Beispiel für den Anfrage-Body:

{
  "data": "{{$json.url}}",
  "size": 512,
  "format": "svg"
}

Fehler, Limits & Nutzung

Was Sie von authentifizierten Anfragen erwarten können.

Authentifizierung

Jeder geschützte Endpunkt erfordert ein gültiges Bearer-Token. Anfragen ohne Token oder mit einem ungültigen oder widerrufenen Token geben 401 Unauthorized zurück.

Tariflimits

Jeder Tarif legt ein monatliches Credit-Kontingent und eine maximale Anzahl aktiver Tokens fest. Sobald Ihre Credits aufgebraucht sind, werden Anfragen bis zum nächsten Zyklus oder einem Tarif-Upgrade abgelehnt.

Validierungsfehler

Ungültige Payloads geben 400 Bad Request mit einem aussagekräftigen Validierungsfehler zurück, der erklärt, welches Feld fehlgeschlagen ist und warum.

Nutzung & Credits

Jeder erfolgreiche Tool-Aufruf verbraucht Credits. Die verbrauchte Menge wird im Feld usage.credits_used jeder Antwort zurückgegeben, damit Sie den Verbrauch verfolgen können.

Demnächst

Weitere Endpunkte sind in der Roadmap geplant.

Einheitenumrechnungs-API
Bildtools-API
MCP-Server-Unterstützung

DecoToolkit entdecken

QR-Code-Generator Alle Tools Kontakt

FAQ

Was ist die DecoToolkit-API?

Mit der DecoToolkit-API können Entwickler und Automatisierungsersteller die DecoToolkit-Tools programmatisch nutzen – aus Skripten, Workflows und KI-Agenten.

Wie authentifiziere ich Anfragen?

Alle API-Anfragen erfordern ein Bearer-Token im Authorization-Header. Sie können Tokens in Ihrem Konto erstellen und verwalten.

Welche Tools sind derzeit verfügbar?

Zu den verfügbaren Endpunkten gehören QR-Code-Generator (POST /v1/tools/qr-code), Textbereinigung (POST /v1/tools/text-cleaner) und JSON-Formatierung (POST /v1/tools/json-formatter). Weitere Tools werden schrittweise hinzugefügt.

Wie werden Nutzung und Credits gezählt?

Jeder erfolgreiche Aufruf verbraucht Credits aus dem monatlichen Kontingent Ihres Tarifs. Die verbrauchte Menge wird im Feld usage.credits_used jeder Antwort zurückgegeben.

Wird DecoToolkit MCP unterstützen?

Die MCP-Server-Unterstützung steht auf unserer Roadmap. Unser Ziel ist es, die DecoToolkit-Tools KI-Agenten über Standardprotokolle zugänglich zu machen.

Kann ich sie mit n8n oder Zapier verwenden?

Ja. Jedes Tool, das HTTP-Anfragen unterstützt – einschließlich n8n, Zapier, Make und eigene Skripte – kann mit der DecoToolkit-API integriert werden.