# API-Schnellstart

## ![](/files/82c3b5997ada163ebf2bf4f743c9b7a7b2e80841) Überblick

Dieser Schnellstart bietet die wesentlichen Informationen, die Sie benötigen, um mit der Flosum Cloud Apps API zu arbeiten. Er soll Ihnen helfen, sich schnell zurechtzufinden, damit Sie mit Zuversicht Anfragen stellen können.

### Verfügbare APIs

Derzeit verfügbare öffentliche Flosum Cloud Apps APIs:

<table><thead><tr><th width="160">API</th><th>Beschreibung</th></tr></thead><tbody><tr><td><a href="/pages/93270e3572b95ad8cbef4f1afc4bdee86143c044">Globale Einstellungen</a></td><td>Authentifizieren Sie die Verbindung zu Ihrem Flosum Cloud Apps-Tenant.</td></tr><tr><td><a href="/pages/b15332fa5b4b1d0a27a170a360aa1459b3a81b8b">Backup &#x26; Archiv</a></td><td>Erstellen, planen, ausführen und verwalten Sie Ihre Backups und Archive.</td></tr></tbody></table>

#### Basis-URL

Die folgende Tabelle listet die Basis-URL für jede API auf. Da Flosum-Tenants regional gehostet werden, verwenden Sie die Basis-URL für die Region, in der Ihr Tenant gehostet wird.

<table><thead><tr><th width="160.3333740234375">API</th><th>Vereinigte Staaten</th><th>Deutschland</th><th>Japan</th><th>Australien</th></tr></thead><tbody><tr><td>Globale Einstellungen</td><td>global-us.flosum.app</td><td>global-de.flosum.app</td><td>global-jp.flosum.app</td><td>global-au.flosum.app</td></tr><tr><td>Backup &#x26; Archiv</td><td>backup-us.flosum.app</td><td>backup-de.flosum.app</td><td>backup-jp.flosum.app</td><td>backup-au.flosum.app</td></tr></tbody></table>

{% hint style="warning" %}

### Verbindungen vs. Organisationen

In der Flosum Cloud Apps API werden die mit Ihrem Tenant verbundenen Salesforce-Organisationen genannt **Verbindungen**, während die Flosum Cloud Apps-Benutzeroberfläche sie als **Organisationen**bezeichnet. Beide Begriffe beschreiben dieselbe Ressource, sodass eine in der Benutzeroberfläche angezeigte Organisation direkt einer von der API zurückgegebenen Verbindung entspricht. Behalten Sie diese Zuordnung im Hinterkopf, wenn Sie UI-Aktionen mit API-Anfragen oder -Antworten abgleichen.
{% endhint %}

## Authentifizierung

Die Flosum Cloud Apps APIs unterstützen die OAuth-2.0-Authentifizierung über die Global Settings API. Nachfolgend finden Sie die grundlegenden Schritte zur Authentifizierung der Verbindung. Dieser Prozess setzt voraus, dass Sie bereits mit der OAuth-2.0-Authentifizierung über den `authorization_code` -Flow vertraut sind.

{% stepper %}
{% step %}

### Connected App erstellen

Um sich bei Ihrem Flosum Cloud Apps-Tenant zu authentifizieren, müssen Sie in Global Settings eine Connected App haben. Diese Connected App stellt die Werte Client ID und Client Secret bereit, die für die Authentifizierung verwendet werden. Um zu erfahren, wie Sie eine Connected App zum Verbinden einer API erstellen, lesen Sie den folgenden Artikel.

* [Eine verbundene App für den API-Zugriff erstellen](/global-settings/global-settings-docs-de/sicherheit/connected-apps/eine-verbundene-app-fur-den-api-zugriff-erstellen.md)
  {% endstep %}

{% step %}

### Autorisierungscode abrufen

**Endpunkt**: [Broken mention](broken://pages/5dfc56925d146e1e3b3c70351f928738bcc5d611#get-api-v1-oauth-authorize)

Öffnen Sie die Autorisierungs-URL in einem Browser, melden Sie sich bei Global Settings an und genehmigen Sie die Connected App. Nachdem der Browser zu Ihrer Callback-URL weitergeleitet hat, kopieren Sie den `code` -Abfrageparameter aus dieser URL.
{% endstep %}

{% step %}

### Code gegen Token austauschen

**Endpunkt**: [Broken mention](broken://pages/5dfc56925d146e1e3b3c70351f928738bcc5d611#post-api-v1-oauth-token)

Senden Sie die Anfrage mithilfe der folgenden Body-Keys.

<table><thead><tr><th width="199.6666259765625">Schlüssel</th><th>Wert</th></tr></thead><tbody><tr><td><code>grant_type</code></td><td><code>authorization_code</code></td></tr><tr><td><code>code</code></td><td>Der <strong>Autorisierungscode</strong> aus dem vorherigen Schritt.</td></tr><tr><td><code>redirect_uri</code></td><td>Die gleiche Redirect-URI, die im vorherigen Schritt verwendet wurde.</td></tr><tr><td><code>client_id</code></td><td>Ihre <code>Client-ID</code></td></tr><tr><td><code>client_secret</code></td><td>Ihre <code>Client Secret</code></td></tr></tbody></table>

Eine erfolgreiche `200` Antwort gibt ein `access_token` und ein `refresh_token`zurück. Übergeben Sie das `access_token` im `Authorization: Bearer` -Header bei nachfolgenden API-Aufrufen und speichern Sie das `refresh_token` damit Sie ein neues Access Token erhalten können, wenn das aktuelle abläuft.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flosum.com/api/api-de/api-schnellstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.