Diese Dokumentation richtet sich an Entwickler, die die Telden API oder den MCP-Server integrieren möchten. Allgemeine Hilfe für Verkäufer und Händler finden Sie im Arbeitsbereich unter „Einstellungen“ und in den einzelnen Produkt-Dossiers.

Erste Schritte

API-Schlüssel

Erstellen Sie workspace-bezogene API-Schlüssel für programmatischen Zugriff.

API-Schlüssel sind mit einem Pro-Abo verfügbar. Test-Workspaces können einen schreibgeschützten Evaluationsschlüssel erstellen.

API-Referenz

Vollständige OpenAPI-Spezifikation mit curl-, JavaScript- und Python-Beispielen.

Schnellstart

Erhalten Sie Ihre erste API-Antwort in unter einer Minute.

Authentifizierungsanleitung

Schnellstart-Anleitung

1. API-Schlüssel erstellen

Gehen Sie zu Einstellungen > Integrationen in Ihrem Workspace. Pro-Workspaces können API-Schlüssel mit vollem Zugriffsumfang erstellen. Test-Workspaces können einen schreibgeschützten Evaluationsschlüssel anlegen.

2. Erste API-Anfrage stellen

Probieren Sie den Health-Endpoint (ohne Authentifizierung) oder listen Sie Ihre SKUs mit Ihrem API-Schlüssel:

Service-Status prüfen (ohne Auth):

curl https://telden.eu/api/health

Ihre Workspace-SKUs mit API-Schlüssel auflisten:

curl https://telden.eu/api/skus \
  -H "Authorization: Bearer YOUR_API_KEY"

3. KI-Agenten konfigurieren

Binden Sie Telden als MCP-Server für Claude Desktop, Cursor oder jeden MCP-kompatiblen Agenten ein:

MCP-Server-Konfiguration (claude_desktop_config.json / .cursor/mcp.json)

{
  "mcpServers": {
    "telden": {
      "url": "https://telden.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${TELDEN_ACCESS_TOKEN}"
      }
    }
  }
}

Ihr API-Schlüssel ist workspace-bezogen. Verwenden Sie das Bearer-Token im Authorization-Header für alle authentifizierten Endpunkte. Ihre Workspace-ID finden Sie oben auf der Einstellungsseite unter „Workspace“.

Produktinformationen

Extraktions-Benchmark

KI-Extraktionsleistung an echten Dokumenten: Datensatz, Methodik, Ergebnisse und ehrliche Grenzen.

MCP-Server

Model-Context-Protocol-Referenz: Endpunkt, Authentifizierung, Bereiche, Werkzeuge und Client-Konfiguration.

FAQ

Häufig gestellte Fragen zum Telden Product Service Desk, Preisen und EU-Compliance.

Hilfe-Center

Benutzerhandbücher und praktische Ressourcen für den Einstieg mit Telden.

Verfügbare Endpunkte

GET/api/healthService-Statusprüfung

GET/api/skusAlle SKUs auflisten

POST/api/skusSKU erstellen

GET/api/skus/{id}Einzelne SKU abrufen

DELETE/api/skus/{id}SKU löschen

GET/api/skus/{id}/documentsMit einer SKU verknüpfte Dokumente auflisten

GET/api/skus/{id}/exportAngereicherte SKU-Daten exportieren (CSV oder JSON)

POST/api/importCSV-/TSV-/Tabellenimport hochladen

GET/api/importsImportstapel auflisten

GET/api/imports/{batchId}Status eines Importstapels abrufen

POST/api/mcpMCP-Agenten-Lesemodell

Vollständige Spezifikation unter /docs/api