> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://support.robaws.com/de/article/webhooks-1yu0buf/) 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. Fülle dieses [**Formular**](https://robaws.notion.site/db4a8c31d1e44191942d1441ba3c0eeb) aus, um loszulegen. 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)
* sales-invoices (Rechnungen)
* purchase-invoices (Eingangsrechnungen)
* time-registration (Auftragsberichte)


## Authorize Endpoint

Request Method: GET
URL: [https://app.robaws.com/oauth2/authorize](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](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](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