Plattform · 03
Zwei APIs, weil Frontend und Backoffice verschiedene Probleme sind.
Die eine ist für die Menschen gebaut, die bieten. Die andere für die Systeme, die Sie ohnehin betreiben. Sie getrennt zu halten heißt, dass keine der beiden die andere ausbremst.
Die öffentliche API
Mit dieser API spricht Ihre eigene Website oder Anwendung. Sie liefert Kataloge, Lose, Bilder und den aktuellen Gebotsstand und nimmt Gebote entgegen. Wenn Sie Ihr Auktions-Frontend selbst bauen wollen — in Ihrem eigenen Framework, auf Ihrer eigenen Domain, mit Ihrem eigenen Designsystem —, dann ist das die Fläche, gegen die Sie entwickeln, und die Plattform wird zu Infrastruktur, die Sie niemandem zeigen müssen.
Es ist dieselbe API, die unsere eigenen Frontends und unsere nativen Apps verwenden. Es gibt keine bevorrechtigte interne Schnittstelle, die wir für uns behalten.
Die Integrations-API
Diese verbindet die Plattform mit den Systemen drumherum. Sie bewegt Daten in großen Mengen hinein und heraus, statt einen stöbernden Bieter zu bedienen.
| Richtung | Typischer Einsatz |
|---|---|
| Lose hinein | Lose automatisch aus Ihrem eigenen Backoffice, Warenwirtschaftssystem oder Einliefererfeed übernehmen, statt sie zu erfassen. |
| Rechnungen hinaus | Käufer- und Einliefererrechnungen in Ihre Buchhaltung übergeben. Kunden fahren das nach Exact. |
| Ergebnisse hinaus | Zuschlagsergebnisse und Abrechnungsdaten an Finanz- oder Berichtssysteme exportieren. |
| Identität | Single Sign-on, damit sich Bieter und Mitarbeiter systemübergreifend mit einer Identität anmelden. |
Der Umfang
Zusammen stellen die beiden APIs rund neunzig Endpunkte in zwanzig Controllern bereit. Die Fläche für Bieter ist Endpunkt für Endpunkt in der API-Referenz auf dieser Website dokumentiert, erzeugt aus der Spezifikation der API selbst, damit sie nicht vom Deployment abweichen kann — und für Entwickler, die lieber live lesen, gibt es Swagger. Eine öffentliche Lesefläche kommt ganz ohne Authentifizierung aus, um freigegebene Lose auf einer Partnerseite oder einer Marketingseite zu zeigen, ohne Zugangsdaten herauszugeben.
Die API-Referenz wird auf Englisch gepflegt: Sie wird aus der OpenAPI-Spezifikation der Plattform erzeugt, und eine übersetzte Kopie würde bei jeder Aktualisierung auseinanderlaufen.
Wofür das tatsächlich gut ist
Die meisten Auktionsplattformen sind eine geschlossene Kiste: Sie bekommen deren Website, deren Verwaltungsmasken und eine Export-Schaltfläche. Das genügt, bis Ihr Geschäft etwas braucht, das die Kiste nicht kann.
Zwei dokumentierte APIs bedeuten, dass die Plattform ein Baustein in Ihrer Architektur ist und kein Ersatz für sie. Sie behalten Ihr CRM, Ihr ERP, Ihre Buchhaltung, Ihre Website — und die Auktion wird zu einem Dienst, mit dem all das spricht.
Was das im Einzelnen umfasst
Die vollständige Funktionsliste →Integration auf der vollständigen Liste →
- Zwei APIs — eine moderne REST-API und eine ältere System-zu-System-APIBauen Sie Ihr eigenes Frontend oder binden Sie Ihre vorhandenen Systeme an, ohne darauf zu warten, dass wir es für Sie bauen.
- Rund neunzig Endpunkte in zwanzig ControllernFast alles, was die Plattform tut, lässt sich aus Ihrer eigenen Software heraus steuern.
- Swagger-DokumentationIhre Entwickler können die API lesen und noch am selben Tag anfangen zu bauen.
- Öffentliche Lese-API ohne AuthentifizierungZeigen Sie Ihre laufenden Lose auf einer Partnerseite oder einer Marketingseite, ohne Zugangsdaten herauszugeben.
- OAuth 2.0 mit OpenID ConnectStandardisierte, aktuelle Authentifizierung, die Ihre Sicherheitsabteilung kennt und akzeptiert.
- Single Sign-on über alle Websites und AppsEine Anmeldung für die Website, die App und das Backoffice.
- Rollen — Administrator, Bieter, GastSysteme, die sich mit Ihnen verbinden, erhalten nur den Zugriff, den sie brauchen.
- Ausgehende Webhooks mit Geheimnis je EndpunktWenn ein Los verkauft wird oder sich ein Bieter registriert, benachrichtigen wir Ihr CRM oder ERP sofort — kein Abfragen, und signiert, damit Sie wissen, dass wir es wirklich sind.
- Event-System, das Bieterprofile in ein CRM speistBauen Sie aus dem, was Bieter tatsächlich tun, ein Bild ihrer Interessen auf und handeln Sie danach in Ihrem CRM.
- Allgemeines Verknüpfungsregister über Objekte hinwegVerbinden Sie alles mit allem — ein Los mit einem Dokument, einen Kunden mit einem Vorgang — ohne Schemaänderung.
- Lose aus einem bestehenden Backoffice importiertNutzen Sie für Ihren Bestand weiter das System, das Sie haben, und spielen Sie Lose von dort in die Auktion.
- Rechnungen in Buchhaltungssysteme exportiertVerkäufe und Abrechnungen landen ohne erneutes Erfassen in Exact oder Ihrer Buchhaltungssoftware.
- Angebote an Invaluable und Lot-tissimo ausgespielt, Gebote zurückverfolgtErreichen Sie das Publikum der Marktplätze, während Sie Ihre eigene Plattform fahren — und sehen Sie, welcher Kanal welches Gebot gebracht hat.
- Stripe, Mollie und QuickPayNehmen Sie Karte, iDEAL und lokale Zahlungsmethoden an, oder binden Sie den Dienstleister an, den Sie bereits nutzen.
- Geplante HintergrundläufeImporte, Exporte und Erinnerungen laufen über Nacht von selbst.