API - Robaws Marktplatz-Integration erstellen (OAuth Endpoints)

Für Marktplatz-Integrationen ist der OAuth2 Authorization Code Flow die erforderliche Authentifizierungsmethode.

Die Anforderungen sind:

• Access-Tokens erst erneuern, wenn sie (fast) abgelaufen sind.
• die Integration zunächst gegen einen Robaws-Testmandanten erstellen.
• Damit deine Integration für die Produktion (im Robaws-Marktplatz) verfügbar wird, ist ein Demovideo erforderlich, in dem du die Integration demonstrierst.
• Du musst uns eine URL zur Verfügung stellen, auf der der Kunde den OAuth2-Flow auf deiner Seite starten kann.
• Polling wird nicht empfohlen. Wenn deine Integration über Änderungen informiert werden soll, solltest du Webhooks verwenden.

Erste Schritte

1. Testmandanten können kostenlos für 14 Tage bereitgestellt werden. Falls nötig, kann dieser Zeitraum verlängert werden.
2. Für eine Marktplatz-Integration benötigst du eine OAuth2-Client-ID und ein Client-Secret.
3. Kontaktiere uns unter support@robaws.com, um loszulegen.
4. Bitte dokumentiere die benötigten Scopes und gib uns außerdem eine Redirect-URL an.

OAuth Endpoints

Hier beschreiben wir die Endpoints, die du brauchst, wenn du eine Integration mit Robaws nach dem OAuth 2 Standard bauen möchtest.

Verfügbare Scopes

• settings (Einstellungen)
• clients (Kunden)
• work-orders (Arbeitsaufträge)
• planning-items (Tagesplanung)
• employees (Mitarbeiter)
• materials (Betriebsmittel)
• installations (Anlagen-Tracking)
• profile (Profil)
• projects (Projekte)
• articles (Artikel)
• posts (Leistungen)
• sales-orders (Aufträge)
• stock-changes (Lagerverwaltung)
• offers (Angebote)
• users (Benutzer)

Authorize Endpoint

Request Method: GET

URL: https://app.robaws.com/oauth2/authorize

Erforderliche Query-Parameter

client_id

redirect_uri

Optionale Query-Parameter

state

response_type (Standard = code)

scope

state

Tokens Endpoint (Authorization Code Flow)

Zum Austausch eines Authorization Codes gegen Access- und Refresh-Token.

Request Method: POST

URL: https://app.robaws.com/oauth2/tokens

Content-Type: application/x-www-form-urlencoded

Erforderliche Body-Parameter

grant_type (authorization_code)

client_id

client_secret

code

redirect_uri

Tokens Endpoint (Refresh)

Zum Austausch eines Refresh-Tokens gegen einen neuen Access- und Refresh-Token.

Request Method: POST

URL: https://app.robaws.com/oauth2/tokens

Content-Type: application/x-www-form-urlencoded

Erforderliche Body-Parameter

grant_type (refresh_token)

client_id

client_secret

refresh_token

Aktualisiert am: 08/01/2026