Eine API für Unternehmensdaten auswählen: 8 Kriterien

1. Die abgedeckten Länder, in einem gemeinsamen Format

Listen Sie die Länder Ihrer Kunden und Lieferanten auf, heute und in zwei Jahren. Prüfen Sie dann, ob jedes Land dasselbe Antwortformat hat: Eine API, die mehrere Länder mit unterschiedlichen Formaten abdeckt, zwingt Sie zu ebenso vielen Integrationen.

Companies deckt Frankreich, Belgien, die Schweiz und das Vereinigte Königreich im selben Format ab. Jedes Unternehmen hat eine globale Kennung aus Länderkürzel und nationaler Nummer: FR-552100554, BE-0417497106, CH-101374515, GB-00445790. Blöcke, die es in einem Land nicht gibt, werden als nicht verfügbar gekennzeichnet, ohne Fehler.

2. Kennungen und ihre Validierung

Eine gute API akzeptiert Nummern so, wie Ihre Nutzer sie eintippen (Leerzeichen, Punkte, Präfixe), und sagt genau, was falsch ist: Format, Prüfziffer, Unternehmen nicht gefunden, Unternehmen geschlossen, Nummern, die nicht zusammenpassen.

Companies akzeptiert die SIREN, die SIRET, die belgische Unternehmensnummer, die Schweizer UID, die britische Handelsregisternummer (company number) sowie französische, belgische und Schweizer USt-IdNr./MWST-Nummern. Die Route GET /v2/validate prüft in einem Aufruf Format, Existenz, Tätigkeit, Übereinstimmung der Nummern und Registrierung der USt-IdNr. und zeigt das Ergebnis jeder Prüfung.

3. Aktuelle Daten

Ein falscher Datensatz kostet mehr als ein fehlender: eine veraltete Adresse, ein gelöschtes Unternehmen, das als aktiv angezeigt wird. Fragen Sie, wie Aktualität sichtbar gemacht wird, und prüfen Sie einige Unternehmen, die Sie gut kennen.

Companies liefert aktuelle Daten, und die Seite Dienststatus zeigt öffentlich den Zustand des Dienstes und der Daten. Jeder Datensatz nennt den Status des Unternehmens (active, closed) und sein Schließungsdatum, falls vorhanden.

4. Antwortzeit und Volumen

In einem Formular muss ein Vorschlag ankommen, während der Nutzer tippt. Bei der Massenverarbeitung zählen Sie den erlaubten Durchsatz und ob Aufrufe gebündelt werden können.

Companies: Autocomplete antwortet serverseitig in wenigen Millisekunden; der Basisdatensatz wiegt etwa 0,5 KB, und zusätzliche Blöcke werden nur auf Anfrage berechnet. POST /v2/companies/batch liest bis zu 100 Unternehmen in einem Aufruf, und ETag-Header vermeiden das erneute Lesen eines unveränderten Datensatzes. Der Durchsatz reicht von 100 Anfragen pro Minute (Free) über 1.000 (Standard) bis 10.000 (Pro), ohne Monatskontingent.

5. Die Verfügbarkeitszusage (SLA)

Unterscheiden Sie ein Ziel von einer Zusage: Nur eine schriftliche SLA mit einer Definition von Ausfallzeit und Entschädigung schützt Sie. Prüfen Sie außerdem, ob es eine öffentliche Statusseite mit der Störungshistorie gibt.

Companies veröffentlicht sein Service Level Agreement: 99,9 % monatliche Verfügbarkeit garantiert mit dem Pro-Tarif, mit einer Gutschrift von 10 bis 50 % des Monatsabonnements bei Nichteinhaltung; dasselbe Ziel von 99,9 %, ohne Gutschrift, mit Standard; ein Best-Effort-Service mit dem kostenlosen Tarif. Eine Minute zählt als nicht verfügbar, wenn der Dienst Serverfehler liefert oder nicht innerhalb von 10 Sekunden antwortet. Die Seite Dienststatus zeigt den Status und die Störungshistorie.

6. Klare Preise und ein kostenloser Tarif

Ein Preis pro Credit oder pro abgerufenem Datensatz ist bei wachsender Nutzung schwer vorherzusagen. Schauen Sie, was beim Zehnfachen Ihres heutigen Volumens passiert und ob ein kostenloser Tarif das Testen ohne Kreditkarte erlaubt.

Companies hat drei Tarife mit festem Preis, veröffentlicht auf der Preisseite: Free für 0 €, Standard für 19 € zzgl. USt pro Monat, Pro für 129 € zzgl. USt pro Monat, mit 20 % Rabatt bei jährlicher Abrechnung. Kein Tarif hat ein Monatskontingent: Die Grenzen gelten für den Durchsatz pro Minute. Der kostenlose Tarif gibt ohne Kreditkarte Zugriff auf jede Route.

7. Dokumentation, Tests und Fehler

Öffnen Sie die Dokumentation, bevor Sie unterschreiben: Jede Route sollte ihre Parameter, eine Beispielanfrage und -antwort und die Liste ihrer Fehler haben. Stabile Fehlercodes und ein Werkzeug zum Testen ohne Code sparen Tage an Integration.

Companies dokumentiert jede Route mit ihren Parametern, einem Beispiel und ihren Fehlern und stellt eine OpenAPI-Spezifikation bereit. Die Demo auf der Startseite fragt die API ohne Konto ab; der Tester in Ihrem Kundenbereich sendet jede Anfrage mit Ihrem Konto. Alle Fehler haben dasselbe Format, mit einem stabilen Code (invalid_identifier, rate_limit_exceeded…) und einem Link zur Dokumentation; die Header X-RateLimit-Remaining und Retry-After zeigen den verbleibenden Durchsatz und die Wartezeit.

8. DSGVO und Hosting in Europa

Fragen Sie, wohin die Daten fließen und wo sie gespeichert werden, was von Ihren Anfragen aufbewahrt wird und wer die Unterauftragsverarbeiter sind. Für einen europäischen Softwareanbieter ist das oft eine Anforderung Ihrer eigenen Kunden.

Companies wird von einem französischen Unternehmen herausgegeben. Die API läuft auf einem Server in Frankreich, und die Konten-Datenbank wird in der Europäischen Union gehostet, in Frankfurt. Das Anfrageprotokoll speichert Datum, Pfad, Status und Dauer, nie den Inhalt der Antworten. Bei der Dateianreicherung verlässt nur die Spalte mit den Kennungen Ihren Rechner. Die Datenschutzerklärung listet die Verarbeitungen, Aufbewahrungsfristen und Unterauftragsverarbeiter auf.

Bonus: Überwachung von Änderungen

Ein Unternehmen am Tag der Anmeldung zu prüfen, genügt nicht: Es kann schließen, umziehen oder in ein Insolvenzverfahren geraten. Eine API, die Sie über Änderungen informiert, erspart Ihnen, regelmäßig alle Ihre Datensätze neu zu lesen.

Companies enthält die Überwachung in jedem Tarif: 2 Unternehmen mit dem kostenlosen Konto, 1.000 mit Standard, 10.000 mit Pro. Jede Änderung (Status, Name, Adresse, Tätigkeit, Insolvenzsignal, Bekanntmachung, Sanktionen) wird zu einem Ereignis, das an einen signierten Webhook und per E-Mail gesendet und 90 Tage lang mit GET /v2/events abrufbar ist. Der Artikel Prüfen, ob ein französisches Unternehmen in Liquidation ist zeigt einen Anwendungsfall.

Den Test in einem Aufruf durchführen

Am einfachsten vergleichen Sie, indem Sie dieselbe Anfrage für ein Unternehmen ausführen, das Sie kennen. Mit Companies, ein belgischer Datensatz mit Adresse, USt-IdNr. und Signalen:

curl "https://companies.jsonpage.com/v2/companies/BE-0417497106?include=address,vat,signals" \
  -H "X-API-Key: $COMPANIES_API_KEY"

Erstellen Sie ein kostenloses Konto, um Ihren Schlüssel zu erhalten, und gehen Sie dann das obige Raster an Ihren eigenen Fällen durch. Antworten auf Fragen zu Tarifen und Verfügbarkeit stehen in den FAQ.

Weiterlesen

• SIRENWas ist eine SIREN-Nummer und wie finden Sie sieDas 9-stellige Format, wer eine erhält, wo sie steht und wie Sie die SIREN eines Unternehmens über den Namen finden.
• USt-IdNr.Französische USt-IdNr.: Format und PrüfungDie französischen, belgischen und Schweizer Formate, die Angaben auf der Rechnung und die Prüfung vor der Rechnungsstellung.
• INSOLVENZVERFAHRENPrüfen, ob ein französisches Unternehmen in Liquidation istLiquidation, Redressement und Sauvegarde erklärt, die Signale, auf die Sie achten sollten, und Alerts zu Ihren Kunden und Lieferanten.