Ihre Daten: Automatisiert. Integriert. Transparent.
Mit unserer API stellen wir Ihre Daten schnell, sicher und zuverlässig in Ihrem Asset Management System zur Verfügung, ohne dass Sie einen Umweg über weitere Programme und manuelle Prozesse nehmen müssen. Durch nahtlose Integration in Ihre Systeme schaffen wir die Basis für Automatisierung und maximale Transparenz in den Abläufen.
Ob aktuelle Reports oder historische Datenbestände – unsere API bietet Ihnen Zugriff auf alle relevanten Informationen, jederzeit und in Echtzeit. Damit können Sie Prozesse optimieren und wertvolle Zeit sparen. Die technische Dokumentation stellen wir Ihnen direkt online zur Verfügung. Die für die Entwicklung verwendeten Webstandards sind OAuth2 und JSON.
API für eine noch effizientere Zusammenarbeit
„Unsere Schnittstellen bringen volle Transparenz, Echtzeit-Einblicke und maximale Effizienz in die Zusammenarbeit: Partner steuern Abholaufträge direkt aus ihren eigenen Systemen, behalten jederzeit den Überblick über den Verarbeitungsstatus und sparen sich den Austausch aufwändiger Excel-Listen.“
Timo Matheja
Product Owner Software bei afb social & green IT
Welche API-Endpunkte gibt es?
Der Kartonshop wird gerne von Partnern genutzt, da er direkt in Systeme wie IDNow oder Asset-Management-Prozesse integriert werden kann. Mit dem Paket-Prozess können Pakete oder Versandlabels erstellt werden, um Geräte auf dem Postweg zu afb zu senden.
Weitere Informationen
Dieser Endpunkt ermöglicht einen Echtzeit-Überblick der von afb übernommenen Geräte inklusive Bearbeitungsstand und weiterführender Daten wie Löschberichten und Angaben zum Zustand. Diese Daten können nach verschiedenen Kriterien wie Geräteart, Bearbeitungsstatus, Übernahmedatum, Ort der Abholung, Abholauftrag und vielen weiteren gefiltert und sortiert werden.
Weitere Informationen
Dieser Endpunkt ermöglicht die Erstellung und Abfrage von Abholaufträgen inklusive der darin enthaltenen Geräte. Sie erhalten einen Echtzeit-Überblick über Status, Abholort und die zwischen Ihnen und afb vereinbarten Servicelevel zur Datenlöschung.
Weitere InformationenIn diesem Abschnitt beschreiben wir alle grundlegend notwendigen Informationen um den initialen Zugriff auf die verschiedenen Endpunkte zu erhalten.
Grundfunktionen
Neben dieser technischen Dokumentation stellen wir eine ausführliche Swagger-Dokumentation bereit. Diese enthält neben den Endpunkt-Informationen auch weitere Details zu Pflichtfeldern und erlaubten Eingabewerten. Die URLs zur Swagger-Dokumentation finden Sie im Abschnitt afb-Systeme.
Bei Fragen zur technischen Einbindung können Sie sich an api@afb-group.eu wenden. Bei allen vertraglichen Fragen wenden Sie sich bitte an Ihre Ansprechperson aus unserem Partnermanagement.
Die Authentifizierung kann entweder mittels OAuth2 oder Benutzername/Passwort erfolgen. Wir empfehlen die Nutzung von OAuth2. Ein erzeugtes Token besitzt eine Gültigkeit von 72 Stunden und muss anschließend erneuert werden.
Jeder Endpunkt verlangt die Angabe eines Mandanten, dieser lautet immer „AfB“.
Unser Testsystem ist stetig im Entwicklungsprozess eingebunden, sodass es hier mehrfach täglich zu einem Neustart kommen kann.
Das Livesystem erhält regelmäßige Updates, die jedoch immer außerhalb der normalen Geschäftszeiten ausgeführt werden (zwischen 20 Uhr und 6 Uhr).
Für die Prüfung der Systemverfügbarkeit stellen wir einen Health-Endpunkt zur Verfügung. Zur Absicherung Ihrer eigenen Integration kann dieser vor der eigentlichen Abfrage genutzt werden.
Die Nutzung der Partner-API setzt einen gültigen Vertrag mit der afb Gruppe voraus. Zudem wird eine Zusatzvereinbarung für die Nutzung der Partner-API ausgestellt.
Falls Sie Interesse an der Nutzung der Partner-API haben, kontaktieren Sie bitte ihren bekannten Partnermanager.
Unsere Systeme erreichen Sie unter folgenden URLs:
| System | Base-URL | Swagger |
| Test-System | https://int.afb.dev.itam.one/int/api/v1 | https://int.afb.dev.itam.one/int/partner-api-doc |
| Produktivsystem | https://portal.afb-group.eu/int/api/v1 | https://portal.afb-group.eu/partner-api-doc/ |
Es gilt grundsätzlich, dass alle ausgegebenen Felder an einem allgemeinen Endpunkt (z.B. „/device“) auch als Filter beim Request verwendet werden. Weitere Details dazu finden Sie in der Swagger-Dokumentation.
Sie haben Fragen? Melden Sie sich gerne bei uns!
Exklusiv für Privatkunden
Sie haben Fragen zu Ihrer Bestellung im afb Onlineshop oder ein anderes Anliegen?
Bitte nutzen Sie hierfür das separate Kontaktformular für Privatkunden oder rufen Sie uns an:
Telefon: +43 16160 313 – 141
Hinweis für Geschäftskunden
Füllen Sie dazu einfach das nebenstehende Formular aus. Unser Team meldet sich anschließend persönlich bei Ihnen.
Kontakt für gewerbliche Anfragen:
Telefon: +43 1 616 03 13-142
E-Mail: partner@afb-group.eu
