API Overview
Klarer Einstieg in die Toolboxx API
Authentifizierte Endpunkte fuer User und Artikel-Items. API-Tokens werden in der Toolboxx unter Einstellungen -> Administration -> API-Tokens erstellt und dann als Bearer Token an jeden Request angehaengt.
Auth
API-Token in Toolboxx erstellen und als Authorization: Bearer <token> mitsenden.
OpenAPI
/openapi.jsonBase URL
https://api.toolboxx.biz/api
Alle Endpunkte sind REST-Resources mit JSON Responses. Pagination ist standardmaessig aktiv.
Public Endpoints
Keine Authentifizierung erforderlich
Login
POST/login
Gibt API Token zurueck. Erwartet email und password.
Lead einreichen
POST/leads/{token}
Oeffentlicher Lead-Eingang. Token wird in der ToolBoxx unter Leads → Quellen erstellt. Nimmt beliebige JSON-Felder entgegen. Optionale IP- und Origin-Whitelist konfigurierbar.
Protected Endpoints
Erfordern Authorization: Bearer <token>
User
GET/user
Gibt den aktuell eingeloggten Benutzer zurueck.
Items Collection
GET/items
Paginiert sortiert nach created_at.
Items Create
POST/items
Erstellt neue Items mit gemappten englischen Feldern.
Item Detail
/items/{item}
Includes Manufacturer, Category und Unit Relation.
DMS Collection
GET/dms
Paginiert sortiert nach created_at.
DMS Upload
POST/dms
Dokument hochladen. Multipart/form-data mit file.
DMS Detail
/dms/{dms}
Dokumentenmanagement Ressource.
Contacts Collection
GET/contacts
Paginiert sortiert nach created_at.
Contacts Create
POST/contacts
Erstellt neue Kontakte mit gemappten englischen Feldern.
Orders Collection
GET/orders
Paginiert sortiert nach created_at.
Orders Create
POST/orders
Erstellt neue Auftraege mit gemappten englischen Feldern.
Order Detail
/orders/{order}
Auftrag Ressource inkl. Positionen.
Contact Detail
/contacts/{contact}
Kontakt Ressource mit allen Daten.
Documents Collection
GET/documents
Rechnungen, Angebote, Auftragsbestätigungen, Lieferscheine & Gutschriften. Filter: ?type=invoice|offer|orderconfirmation|deliverynote|creditnote
Documents Create
POST/documents
Erstellt Dokument mit Positionen. Pflichtfeld: type.
Document Detail
/documents/{document}
Dokument inkl. Positionen. Typ kann nicht geaendert werden.