Eagle Doc - Dokumentenverarbeitung mit einem Business-Schlüssel

Verarbeitungs-Endpunkte

Jeder Extraktions-Endpunkt, den Sie bereits verwenden, funktioniert unverändert mit einem Business-API-Schlüssel. Nur zwei Dinge unterscheiden sich von einer persönlichen Integration: Sie authentifizieren sich mit einem APIB-…-Schlüssel und können einen optionalen Header hinzufügen, um jede Anfrage einem Kunden zuzuordnen. Die Anfrage- und Antwort-Bodies sind identisch zur persönlichen API.

Alle Aufrufe gehen an dieselbe Basis-URL https://de.eagle-doc.com. Dokumente werden als multipart/form-data mit einem einzelnen file-Feld (PNG, JPEG oder PDF) hochgeladen — genau wie bisher.

Gleiche Bodies, gleiche Antworten

Da die Payloads identisch zur persönlichen API sind, wiederholt diese Seite die feldweisen Tabellen nicht. Folgen Sie für jeden Endpunkt unten dem Link „Vollständige Feldreferenz“ zur kompletten Dokumentation von Anfrage und Antwort.

Anfrage-Header

Nur die folgenden Header ändern, wie eine Anfrage authentifiziert und zugeordnet wird. Alles Weitere an der Anfrage ist identisch zu einem Aufruf mit persönlichem Schlüssel.

Header	Description
`api-key` Required	Ihr Business-API-Schlüssel, z. B. `APIB-your-business-key`. Das Präfix `APIB-` macht den Aufruf business-bezogen.
`x-sub-business-ref` `x-sub-business-id` Optional	Ordnet die Anfrage einem Ihrer Kunden zu. Senden Sie `x-sub-business-ref` mit Ihrer eigenen Kundennummer oder `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Siehe den Leitfaden Kunden & Zuordnung.
`Content-Type`	Auf `multipart/form-data` für den Datei-Upload setzen. Die meisten HTTP-Clients fügen dies automatisch hinzu, wenn Sie das `file`-Feld anhängen.

Dem Business selbst zuordnen

Lassen Sie den Kunden-Header vollständig weg, um die Anfrage dem Haupt-Business statt einem bestimmten Kunden zuzuordnen.

Beliebiges-Dokument-OCR

Extrahieren Sie strukturierte Daten aus einem beliebigen Dokument. Fügen Sie mit einem Business-Schlüssel den optionalen Kunden-Header hinzu, um die Extraktion zuzuordnen.

Parameters

Name	Description
api-key (header)	Ihr Business-API-Schlüssel (`APIB-…`). Erforderlich.
x-sub-business-ref (header)	Optional. Ihre Kundennummer, um die Anfrage einem Kunden zuzuordnen. Alternativ senden Sie `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Lassen Sie beide weg, um dem Business selbst zuzuordnen.
file (form-data)	Das zu verarbeitende Dokument (PNG, JPEG oder PDF), gesendet als `multipart/form-data`.

Example request

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

import requests

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

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("document.pdf")]), "document.pdf");

const resp = await fetch("https://de.eagle-doc.com/api/anydoc/v1/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());

Full field reference

Anfrage- und Antwort-Bodies sind identisch zur persönlichen API. Siehe die vollständige Feldreferenz: Vollständige Referenz zu Beliebiges-Dokument-OCR →

Rechnungs-OCR

Extrahieren Sie strukturierte Rechnungsdaten. Authentifizierung und Kundenzuordnung funktionieren genau wie bei den anderen Endpunkten.

Parameters

Name	Description
api-key (header)	Ihr Business-API-Schlüssel (`APIB-…`). Erforderlich.
x-sub-business-ref (header)	Optional. Ihre Kundennummer, um die Anfrage einem Kunden zuzuordnen. Alternativ senden Sie `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Lassen Sie beide weg, um dem Business selbst zuzuordnen.
file (form-data)	Das zu verarbeitende Dokument (PNG, JPEG oder PDF), gesendet als `multipart/form-data`.

Example request

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

import requests

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

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("invoice.pdf")]), "invoice.pdf");

const resp = await fetch("https://de.eagle-doc.com/api/invoice/v1/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());

Base64-Variante

Unter /api/invoice/v1/base64/processing steht eine Base64-Variante für Integrationen bereit, die die Datei lieber als codierte Zeichenkette statt als Multipart senden. Sie akzeptiert denselben Business-Schlüssel und Kunden-Header.

Full field reference

Anfrage- und Antwort-Bodies sind identisch zur persönlichen API. Siehe die vollständige Feldreferenz: Vollständige Referenz zu Rechnungs-OCR →

Beleg-OCR

Extrahieren Sie strukturierte Belegdaten. Der Business-Schlüssel und der optionale Kunden-Header verhalten sich wie überall sonst.

Parameters

Name	Description
api-key (header)	Ihr Business-API-Schlüssel (`APIB-…`). Erforderlich.
x-sub-business-ref (header)	Optional. Ihre Kundennummer, um die Anfrage einem Kunden zuzuordnen. Alternativ senden Sie `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Lassen Sie beide weg, um dem Business selbst zuzuordnen.
file (form-data)	Das zu verarbeitende Dokument (PNG, JPEG oder PDF), gesendet als `multipart/form-data`.

Example request

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());

Full field reference

Anfrage- und Antwort-Bodies sind identisch zur persönlichen API. Siehe die vollständige Feldreferenz: Vollständige Referenz zu Beleg-OCR →

Dokument-Split

Teilen Sie eine Datei mit mehreren Dokumenten in ihre einzelnen Dokumente auf. Senden Sie sie mit dem Business-Schlüssel, optional einem Kunden zugeordnet.

Parameters

Name	Description
api-key (header)	Ihr Business-API-Schlüssel (`APIB-…`). Erforderlich.
x-sub-business-ref (header)	Optional. Ihre Kundennummer, um die Anfrage einem Kunden zuzuordnen. Alternativ senden Sie `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Lassen Sie beide weg, um dem Business selbst zuzuordnen.
file (form-data)	Das zu verarbeitende Dokument (PNG, JPEG oder PDF), gesendet als `multipart/form-data`.

Example request

curl --location 'https://de.eagle-doc.com/api/doc/v1/split' \
  --header 'api-key: APIB-your-business-key' \
  --header 'x-sub-business-ref: A-1023' \
  --form 'file=@"document.pdf"'

import requests

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

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("document.pdf")]), "document.pdf");

const resp = await fetch("https://de.eagle-doc.com/api/doc/v1/split", {
  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());

Full field reference

Anfrage- und Antwort-Bodies sind identisch zur persönlichen API. Siehe die vollständige Feldreferenz: Vollständige Referenz zu Dokument-Split →

Finanz-OCR

Finanz-OCR erkennt den Dokumenttyp automatisch (zum Beispiel Rechnung oder Beleg) und liefert die passenden strukturierten Daten. Sie nimmt den Business-Schlüssel und den optionalen Kunden-Header genau wie die anderen Endpunkte entgegen.

Parameters

Name	Description
api-key (header)	Ihr Business-API-Schlüssel (`APIB-…`). Erforderlich.
x-sub-business-ref (header)	Optional. Ihre Kundennummer, um die Anfrage einem Kunden zuzuordnen. Alternativ senden Sie `x-sub-business-id` mit der Eagle-Doc-Kunden-ID. Lassen Sie beide weg, um dem Business selbst zuzuordnen.
file (form-data)	Das zu verarbeitende Dokument (PNG, JPEG oder PDF), gesendet als `multipart/form-data`.

Example request

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

import requests

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

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("document.pdf")]), "document.pdf");

const resp = await fetch("https://de.eagle-doc.com/api/finance/v1/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());

Full field reference

Anfrage- und Antwort-Bodies sind identisch zur persönlichen API. Siehe die vollständige Feldreferenz: Vollständige Referenz zu Finanz-OCR →

Batch- & asynchrone Endpunkte

Auch die Batch- und asynchronen Task-Endpunkte akzeptieren Business-Schlüssel und den optionalen Kunden-Header — zum Beispiel /api/anydoc/extract/batch/task/v1 und /api/finance/extract/batch/task/v1. Authentifizieren Sie sich mit Ihrem APIB-…-Schlüssel und fügen Sie x-sub-business-ref genau wie oben gezeigt hinzu. Batch-OCR-Dokumentation →

Identische Antwortstrukturen

Die Antwortstrukturen sind identisch zur persönlichen API — die Felder finden Sie in der vollständigen Referenz des jeweiligen Endpunkts.

Support

Wir helfen Ihnen gerne

Sie bauen Ihre Integration für mehrere Kunden auf und etwas ist unklar? Wir helfen Ihnen gerne, damit Ihr Projekt gelingt.

Erreichen Sie uns unter support@eagle-doc.com

DOKUMENTENVERARBEITUNG

Anfrage-Header

Beliebiges-Dokument-OCR

Rechnungs-OCR

Beleg-OCR

Dokument-Split

Finanz-OCR

Batch- & asynchrone Endpunkte

Support

Über Eagle Doc

Produkte

Ressourcen

Wichtige Links