Skip to main content

Entwicklerdokumentation

Entwicklerdokumentation für die Produktsicherheits-Workbench für EU-Händler.

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.

Diese Dokumentation ist derzeit nur auf Englisch verfügbar.

Erste Schritte

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

API-Schlüssel sind in Growth- und Pro-Plänen verfügbar. Early-Access-Workspaces erhalten einen kostenlosen schreibgeschützten Schlüssel zur Evaluierung. Pro schaltet den vollen Scope-Zugriff einschließlich Schreiben, Export und Import frei.

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 in Ihrem Workspace zu Einstellungen > Integrationen. Pro-Workspaces können API-Schlüssel mit allen Scopes erstellen. Early-Access-Workspaces können einen schreibgeschützten Schlüssel zur Evaluierung erstellen.

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

26 stabile und 15 Preview-Operationen aus dem öffentlichen OpenAPI-Vertrag.

Stabile Endpunkte

GET/api/healthPublic liveness probe. No authentication required.
GET/api/health/emailStaff-only email readiness probe (Brevo SMTP). Requires staff authentication.
GET/api/skusList SKUs for the current workspace.
POST/api/skusCreate a SKU in the current workspace. Supports dry_run and Idempotency-Key.
GET/api/skus/{id}Get a SKU with agent-readable blocker and capability flags.
DELETE/api/skus/{id}Delete a SKU and related records in the current workspace.
GET/api/skus/{id}/documentsList documents linked to a SKU (legacy sku_id column and document_sku join).
GET/api/skus/{id}/dossier.zipDownload one SKU dossier PDF together with all attached documents as a ZIP archive.
GET/api/skus/{id}/exportExport one SKU as JSON or CSV. Bearer auth requires the `export` scope (paid/enterprise plans).
POST/api/skus/{id}/fields/{fieldId}/sync-from-entityCopy the current confirmed linked entity value into a dossier field. Supports dry_run and Idempotency-Key.
POST/api/skus/{id}/review/completeMark a SKU review as complete after all issues and extraction conflicts are resolved.
GET/api/importsList recent import batches for the current workspace.
GET/api/imports/{batchId}Get one import batch summary.
POST/api/importUpload and process a CSV, TSV, XLSX, XLS, or ODS SKU import.
GET/api/workspace/api-keysList active workspace API keys.
POST/api/workspace/api-keysCreate a workspace API key.
DELETE/api/workspace/api-keys/{id}Revoke a workspace API key.
POST/api/workspace/api-keys/{id}Rotate a workspace API key (revoke old key and create a new one).
GET/api/v1/skusList workspace SKUs via Bearer-token auth. Requires API key with skus:read scope.
POST/api/skus/{id}/ai-fillTrigger AI fill for a SKU's missing dossier fields. Creates a background job and returns immediately. AI suggestions require human review and are never auto-approved for compliance output.
GET/api/skus/{id}/ai-fill/jobPoll the latest AI-fill job status for a SKU.
POST/api/skus/{id}/ai-fill/cancelCancel a running AI-fill job (pending or processing).
POST/api/supplier-email/draftGenerate a supplier outreach email draft for missing compliance documents.
POST/api/supplier-email/sendSend a supplier outreach email via workspace SMTP.
GET/api/supplier-email/requestsList sent supplier email requests for a SKU.
PATCH/api/supplier-email/requests/{id}Update supplier email request status.

Preview-Endpunkte

Preview-Routen sind in OpenAPI dokumentiert, aber noch keine Kompatibilitätszusage.

GET/api/mcpMCP server info and health check (WebStandardStreamableHTTP transport).
POST/api/mcpCall the read-only Telden MCP server.
POST/api/classifyClassify a file as product CSV, compliance document, or other.
POST/api/classify/containersExpand supported containers (.zip, .eml, RFC 2822 .msg) and classify each extracted part. Nested .zip/.eml recurse up to recursion_limit (3); encrypted archives, opaque .p7m, and Outlook compound .msg return skipped diagnostics.
POST/api/documents/bulkUpload up to 20 compliance documents in one multipart batch.
POST/api/upload/orchestrateRecord upload orchestration audit events for classified files.
GET/api/imports/{batchId}/reviewGet post-import batch review workbench payload for imported SKUs, suggestions, and provenance.
POST/api/imports/{batchId}/entity-resolutionValidate and persist linked-entity resolution decisions for an import batch.
POST/api/import/from-urlPreview a product import from a public shop or catalog URL.
POST/api/v1/skus/{id}/re-extractTrigger re-extraction of a SKU's linked documents via Bearer-token auth. Requires API key with extractions:write scope.
POST/api/v1/documents/{id}/re-extractTrigger re-extraction of a document via Bearer-token auth. Requires API key with extractions:write scope.
POST/api/research/productResearch missing product data from public sources and return cited suggestions only.
GET/api/exportsList past export runs for the current workspace.
POST/api/exportsTrigger a new export run with a chosen template and scope.
GET/api/exports/templatesList available export templates for the current workspace.

Vollständige Spezifikation unter /docs/api · /api/openapi.json