Entdecken Sie die neuesten Verbesserungen der öffentlichen API RO App, mit denen Sie nahtlose Integrationen und Automatisierungen mit Drittanbieterdiensten erstellen können.
Vereinfachte Authentifizierung mit Bearer-Token
Sie können Anfragen nun mithilfe der Standard-Bearer-Authentifizierung authentifizieren:
Authorization: Bearer YOUR_API_KEY
Dies ist die standardmäßige Bearer-Authentifizierung, die die Integration einfacher und schneller macht.
Wichtig: Die alte Autorisierungsmethode (POST /token/new) ist veraltet und wird am 1 September 2025 deaktiviert. Bitte wechseln Sie rechtzeitig zur neuen Methode, um einen unterbrechungsfreien Zugriff zu gewährleisten.
Neue Endpunkte für Bestellungen und Kostenvoranschläge
Wir haben die API umstrukturiert und neue Endpunkte für die Arbeit mit Bestellungen/Tickets/Aufträgen und Kostenvoranschlägen hinzugefügt, wodurch sie flexibler und REST-orientierter geworden sind.
Die alten Methoden bleiben bis zum 1 September 2025 verfügbar, gelten jedoch nun als veraltet. Nach diesem Datum werden sie deaktiviert. Wir empfehlen daher, vorab auf die neuen Endpunkte umzusteigen.
Dokumentation: https://roapp.readme.io/reference/get-orders
Bestellung und Kostenvoranschlag Artikel-Liste als separate Ressource
Wir haben die API-Struktur für die Bearbeitung von Aufträgen (einschließlich Tickets und Jobs) und Kostenvoranschlägen neu gestaltet, um sie flexibler und REST-konform zu machen.
Die alten Endpunkte bleiben bis zum 1 September 2025 verfügbar, sind jedoch nun veraltet.
Artikellisten als separate Ressource
Produkte und Dienstleistungen innerhalb von Bestellungen und Kostenvoranschlägen werden nun als separate Artikelressource behandelt, was die Übersichtlichkeit und Flexibilität verbessert.
GET /orders/{id} — gibt allgemeine Bestelldetails zurück
GET /orders/{id}/items — gibt die Liste der Elemente zurück
Außerdem werden das Hinzufügen und Aktualisieren von Elementen in Dokumenten unterstützt:
POST /orders/{id}/items — fügt einen Artikel hinzu (Hinweis: Produkte werden ohne Bestandsabzug hinzugefügt)
PATCH /orders/{id}/items/{item_id} — Aktualisiert Artikeldetails (Preis, Menge usw.)
Die gleiche Struktur ist für Schätzungen über /estimates/{id}/items
Diese Erweiterung schafft die Grundlage für die Integration mit Online-Shops und Marktplätzen, wo importierte Bestellungen eine vollständige Artikelliste enthalten. Wir arbeiten bereits an einer direkten Integration mit Shopify. Sie können diese Endpunkte auch verwenden, um die RO App mit Ihren eigenen E-Commerce-Plattformen zu verbinden.
Neues ISO 8601-Datumsformat
Alle neuen Endpunkte verwenden nun das Datumsformat ISO 8601. Beispiel:
"createdAt": "2025-05-14T08:35:05Z"
Flexible Paginierung mit pageSize
Endpunkte mit Paginierung (GET /orders, GET /estimates) unterstützen nun den Parameter pageSize:
Akzeptable Werte: 10 to 100
Standard: pageSize=50
Sie können den Wert für schnellere Antworten verringern oder ihn erhöhen, um mehr Daten in einer einzigen Anfrage abzurufen.
Wenn Sie Feedback oder Vorschläge haben, würden wir uns freuen, von Ihnen zu hören. Kontaktieren Sie einfach unser Support-Team per Chat.