INTEGRATION FÜR BUSINESS MIT KUNDEN

Dieser Leitfaden zeigt, wie Sie Eagle Doc als Unternehmen integrieren und Dokumente im Auftrag Ihrer Kunden verarbeiten. Sie rufen weiterhin dieselben Beleg-, Rechnungs-, Beliebiges-Dokument-, Split- und RAG-Endpunkte auf — Sie authentifizieren sich lediglich mit einem Business-API-Schlüssel und markieren jede Anfrage optional mit dem zugehörigen Kunden.

Was für Integratoren neu ist

Zwei additive Mechaniken machen aus jeder Eagle-Doc-Integration eine Integration für mehrere Kunden:

• Business-API-Schlüssel — mit dem Präfix APIB-… und im selben api-key-Header gesendet. Die Nutzung wird dem Business-Abonnement in Rechnung gestellt, nicht einer einzelnen Person.
• Zuordnung pro Kunde — ein optionaler Header markiert jede Anfrage mit einem Ihrer Kunden (einem „Sub-Business“), sodass Nutzung, Dokumente und gelernte RAG-Beispiele pro Kunde getrennt werden.

Kernkonzepte

Schnellstart

In fünf Schritten von null zu einer kundenbezogenen Extraktion.

1. Business und Business-API-Schlüssel erstellen

   Erstellen Sie im Dashboard ein Business, öffnen Sie dann Einstellungen → API-Schlüssel und kopieren Sie einen neuen APIB-…-Schlüssel. Sie können dies auch automatisieren — siehe Authentifizierung.

2. Mit dem Business-Schlüssel authentifizieren

   Senden Sie ihn im selben api-key-Header, den Sie bereits verwenden — das Präfix APIB- macht den Aufruf business-bezogen.

3. Kunde markieren (ohne Vorbereitung)

   Fügen Sie x-sub-business-ref mit Ihrer eigenen Kundennummer hinzu. Bei der ersten Verwendung legt Eagle Doc den Kunden automatisch an — Sie registrieren nichts vorab.

4. Beliebigen Extraktions-Endpunkt aufrufen

   Alles Weitere ist identisch zu einer Integration mit persönlichem Schlüssel. Hier eine Beleg-Extraktion, zugeordnet zu Kunde A-1023:

   cURL Python Node.js Copy

   curl --location 'https://de.eagle-doc.com/api/receipt/v3/processing' \
     --header 'api-key: APIB-your-business-key' \
     --header 'x-sub-business-ref: A-1023' \
     --form 'file=@"receipt.jpeg"'

   import requests
   
   resp = requests.post(
       "https://de.eagle-doc.com/api/receipt/v3/processing",
       headers={
           "api-key": "APIB-your-business-key",
           "x-sub-business-ref": "A-1023",   # your own client number
       },
       files={"file": open("receipt.jpeg", "rb")},
   )
   print(resp.json())

   import fs from "node:fs";
   
   const form = new FormData();
   form.append("file", new Blob([fs.readFileSync("receipt.jpeg")]), "receipt.jpeg");
   
   const resp = await fetch("https://de.eagle-doc.com/api/receipt/v3/processing", {
     method: "POST",
     headers: {
       "api-key": "APIB-your-business-key",
       "x-sub-business-ref": "A-1023", // your own client number
     },
     body: form,
   });
   console.log(await resp.json());

5. Nutzung prüfen

   Rufen Sie GET /api/usage/v1/current mit dem Business-Schlüssel für das gebündelte Kontingent auf oder sehen Sie die Aufschlüsselung pro Kunde im Dashboard. Siehe Nutzung & Kontingent.

Die Leitfäden entdecken

Support