> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Integration für Business

> Ermöglichen Sie Ihren Nutzern, ihre Social-Media-Konten zu verbinden

Ein wichtiger Teil der Integration in den Business-Plan oder den [Launch-Plan](/multiple-users/business-launch-overview) besteht darin, für Ihre Nutzer oder Kunden neue Profil-Accounts in Ayrshare zu erstellen und ihnen zu ermöglichen, ihre sozialen Netzwerke über die [Social-Linking-Seite](/multiple-users/user-integration) zu verknüpfen.
Jeder Ihrer Nutzer wird als Ayrshare-User-Profile eingerichtet. Ein User Profile erhält jeweils eine Verbindung zu jedem sozialen Netzwerk.

<Note>
  **Dies ist der Standardweg für das Onboarding von Kunden.** Ihre Nutzer verbinden ihre eigenen
  Social-Media-Konten über die unten beschriebene, mit einem White-Label versehene JWT-URL-Connect-Seite –
  sie melden sich nie bei Ayrshare an und greifen nie auf Ihr Dashboard zu. Das
  [Dashboard](/multiple-users/manage-user-profiles#using-the-dashboard) ist Ihrem internen Team
  vorbehalten (zum Erstellen und Verwalten von Profilen, zum Testen und zum Posten im Namen eines
  Kunden).
</Note>

## Integrations-Workflow

Um Ayrshare in Ihre Anwendung zu integrieren, müssen Sie zwei API-Aufrufe durchführen:

1. Rufen Sie den [Create Profiles-Endpoint](/apis/profiles/create-profile) auf, um für Ihren Nutzer ein neues Ayrshare-Profil zu erstellen.
2. Rufen Sie den [Generate JWT-Endpoint](/apis/profiles/generate-jwt) auf, um eine JWT-URL zu erhalten.

Die JWT-URL ermöglicht Ihrem Nutzer den sicheren Zugriff auf die Social-Linking-Seite über eine Single-Sign-On-Authentifizierung.
Sie zeigen diese Seite in einem neuen Tab, Fenster oder View-Controller an, damit Nutzer ihre Social-Media-Konten verbinden können.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/multiple-users/linking-flow.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=5a6d2569f89cefbb3ce85837bbd2a9c3" alt="Workflow für die Verknüpfung von User Profiles" width="3408" height="2069" data-path="images/multiple-users/linking-flow.webp" />

Nachdem Ihr Nutzer seine Social-Media-Konten verknüpft hat, können Sie über die API Beiträge veröffentlichen, Analytics abrufen und die Konten verwalten.

<Note>
  Aus Sicherheitsgründen verlangen Social-Media-Plattformen, dass sich Nutzer über ihren Browser
  authentifizieren, was nicht über Backend-Server-Aufrufe möglich ist. Dies stellt sicher, dass
  Ihre Nutzer ihre Social-Media-Konten sicher verbinden können, indem sie sich direkt über die
  offizielle Login-Seite jeder Plattform anmelden. Soziale Netzwerke erlauben die Authentifizierung
  nur über ihre autorisierten Partner-Domains wie Ayrshare. Sie blockieren außerdem iFrames, was
  bedeutet, dass Sie die Ayrshare-Linking-Seite nicht in einem iFrame auf Ihrer Website einbetten
  oder anzeigen können.
</Note>

## Ein Ayrshare-User-Profile erstellen

### Ein Profil mit der API erstellen

Wenn sich ein neuer Nutzer in Ihrem System registriert oder Ihr Kunde in Ihrer App auf den Social-Network-Link klickt, erstellen Sie einen neuen Ayrshare-Profil-Account, indem Sie den RESTful-Endpoint [/profiles/create-profile](/apis/profiles/create-profile) aufrufen oder die [NPM](/packages-guides/nodejs)- oder [PyPi](/packages-guides/python)-Pakete verwenden.

<Card title="Profiles" icon="code" href="/apis/profiles/overview" horizontal />

Dieser Aufruf gibt den *PROFILE KEY* Ihres Nutzers zurück. Dieser Schlüssel wird verwendet, um im Namen Ihres Nutzers zu posten und dessen Konto zu verwalten. Sie sollten ihn an einem sicheren Ort speichern.

### Ein Profil über das Dashboard erstellen (Internes Team)

Ihr internes Team kann User Profiles auch direkt aus dem **Developer Dashboard** erstellen – nützlich für Tests, manuelles Onboarding eines Profils oder einmalige administrative Aufgaben. Dies ist ein Team-Tool, kein kundenorientierter Ablauf: Ihre Kunden erhalten niemals Zugriff auf das Dashboard und werden immer über die [JWT-URL-Connect-Seite](#single-sign-on-with-jwt-authentication) onboardet. Erstellen Sie Profile für das produktive Onboarding programmatisch über die [API](/apis/profiles/create-profile), damit jeder neue Nutzer automatisch bereitgestellt wird.

<Card title="User Profiles im Dashboard verwalten" icon="link" href="/multiple-users/manage-user-profiles#using-the-dashboard" horizontal />

### Integrations-Paket

Während Ihres Onboardings als Business-Plan- oder Launch-Plan-Kunde haben Sie ein personalisiertes Integrations-Paket mit wichtigen Setup- und Domain-Informationen, Beispiel-Endpoint-Aufrufen und mehr erhalten. Bitte wenden Sie sich für diese Informationen an Ihren primären Account-Inhaber.

Sie können das Integrations-Paket auch im Dashboard auf der API-Seite abrufen oder zurücksetzen. Wechseln Sie zuerst zu Ihrem Primary Profile.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/multiple-users/integration.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=ce8b1f0b733f87ad61d75f66029b84df" alt="Ayrshare Integration Package" width="900" height="200" data-path="images/multiple-users/integration.webp" />

## Single Sign-On mit JWT-Authentifizierung

Ayrshare verwendet ein JWT (JSON Web Token), um Ihren Nutzer zu authentifizieren und Single Sign-On zur Social-Linking-Seite durchzuführen. Ein JWT ist ein sicherer Mechanismus zur Übertragung digital signierter Informationen und erlaubt Ayrshare, Sie und Ihren Nutzer zu authentifizieren.

### Ein JWT generieren

Ihre App erstellt ein JWT, bestehend aus Ihrem API-Key, dem Profile Key des Nutzers und einigen weiteren Parametern. Es wird mit Ihrem privaten 1024-Bit-Schlüssel signiert.

<Note>
  Das JWT-Token ist 5 Minuten gültig. Für eine längere Ablaufzeit siehe [Max Pack](/additional/maxpack).
</Note>

Bitte verwenden Sie den [Generate JWT-Endpoint](/apis/profiles/generate-jwt), damit Ayrshare das Token und die Social-Linking-URL erstellt. Öffnen Sie die Social-Linking-URL in einem neuen Tab oder Fenster, damit Ihre Nutzer ihre [sozialen Netzwerke einfach verknüpfen](/multiple-users/user-integration) können.

<Note>
  Die JWT-URL ist der empfohlene Onboarding-Weg für jeden Kunden. Ihre Nutzer authentifizieren sich
  eigenständig direkt bei jedem sozialen Netzwerk – Sie sammeln oder speichern niemals deren
  Social-Media-Zugangsdaten. Wenn Ihr Team ein Konto während des Testens manuell verknüpfen muss,
  können Sie das über das Dashboard tun, aber dies ist eine interne Erleichterung und nicht der
  Weg, auf dem Kunden onboardet werden sollten.
</Note>

### White-Labeling der Connect-Accounts-Seite

Da die vom JWT-URL geöffnete Connect-Seite die einzige Ayrshare-Oberfläche ist, die Ihre Nutzer jemals sehen, sollten Sie sie als Ihre eigene branden. Fügen Sie Ihr Logo und benutzerdefinierte Header hinzu, wählen Sie aus, welche sozialen Netzwerke erscheinen, legen Sie die Sprache der Seite fest und verwenden Sie Ihre eigenen Hilfelinks – und mit dem [Max Pack](/additional/maxpack) wenden Sie eine vollständige benutzerdefinierte CSS-Datei, ein Favicon, einen Seitentitel und einen Footer an. Diese Optionen werden einmal von Ihrem Team über das Primary Profile konfiguriert und gelten für jede von Ihnen generierte JWT-URL.

<Card title="Connect-Accounts-Seite mit White-Label versehen" icon="palette" href="/multiple-users/manage-user-profiles#white-label-the-connect-accounts-page" horizontal>
  Sehen Sie sich alle Branding- und Anpassungsoptionen für die Connect-Seite an.
</Card>

### Automatisches Abmelden einer Profilsitzung

<Warning>
  **So melden Sie sich automatisch aus der aktiven Profilsitzung ab**

  Wenn ein Profil bereits angemeldet ist, führt das Senden des JWT eines anderen Profils nicht zu einem Profilwechsel. Dies ist so gestaltet, um die Nutzung für bereits angemeldete Nutzer schneller zu gestalten. Melden Sie sich beim Testen vom aktuellen Profil ab, bevor Sie einen SSO-Aufruf mit einem anderen Profil durchführen. Angemeldete Profile bleiben angemeldet, bis sie explizit abgemeldet werden.

  Wenn Sie jedoch einen geschäftlichen Bedarf haben – etwa weil Ihre Nutzer mehrere Profile besitzen, auf die sie häufig zugreifen, oder wenn Sie testen möchten –, fügen Sie den URL-Parameter zur SSO-URL hinzu:

  `logout=true`

  Zum Beispiel:

  `https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=true`

  Dies erzwingt einen Logout und meldet dann das neue Profil an.

  Siehe außerdem den [Generate JWT-Endpoint](/apis/profiles/generate-jwt), um den Logout automatisch hinzuzufügen.

  **Warnung**: Die Verwendung des automatischen Logouts verursacht eine Performance-Verzögerung für Ihren Nutzer. Sofern Sie ihn nicht benötigen, empfehlen wir, keinen Logout zu erzwingen und ihn in der Produktion nicht zu verwenden.
</Warning>

## Öffnen und Schließen der Social-Linking-URL

Die Social-Accounts-Seite hat eine „Close"-Schaltfläche, die das Fenster schließt und Ihren Nutzer zu Ihrer Seite zurückführt.

### Öffnen der Social-Linking-URL

Beim Öffnen der Social-Linking-URL empfehlen wir, die JavaScript-Funktion `window.open()` anstelle eines Anchor-href zu verwenden.
Die „Close"-Schaltfläche verwendet JavaScript zum Schließen des Fensters, und die meisten Browser erlauben nur das Schließen von Fenstern, die über ein Skript geöffnet wurden.
Sie können den folgenden Beispielcode auf Ihrer Website verwenden, um das Social-Linkage-Fenster zu starten.

```html Window Open theme={"system"}
<div onclick="window.open('https://profile.ayrshare.com?domain...', '_blank')">
  Link Social Networks
</div>
```

oder

```html Window Open Function theme={"system"}
<button onclick="openNewTabAndRedirect()">Open New Tab and Redirect</button>
<script>
  function openNewTabAndRedirect() {
    // Open a new tab
    var newTab = window.open("https://profile.ayrshare.com?domain...");

    // Optional: Focus on the new tab
    newTab.focus();
  }
</script>
```

Sie können steuern, wie die „Close"-Schaltfläche entweder den Social-Linking-Tab auf eine Seite Ihrer Wahl umleitet oder den ursprünglichen Opener-Tab/das Fenster umleitet und den Social-Linking-Tab schließt.
Dies kann über den redirect-Parameter erfolgen, indem Sie den Query-Parametern der Redirect-URL `origin=true` hinzufügen.
Weitere Details finden Sie beim [Generate JWT-Endpoint](/apis/profiles/generate-jwt).

### Umleitung beim Schließen

Wenn Sie außerdem möchten, dass die `Close`-Schaltfläche zurück zu Ihrer Seite umleitet (oft nützlich auf Mobilgeräten), übergeben Sie den GET-Parameter `redirect` als *URL-kodierten* String, der mit https beginnt.
Weitere Details finden Sie unter [Generate JWT-Endpoint-Parameter](/apis/profiles/generate-jwt#body-parameters).

```javascript JWT URL theme={"system"}
https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&redirect=https%3A%2F%2Fmywebsite.com
```

Die Weiterleitung wird für dieses Profil gespeichert und in nachfolgenden SSO-Aufrufen verwendet, auch wenn der Parameter `redirect` nicht übergeben wird.
Um die `Close`-Schaltfläche wieder auf Schließen zurückzusetzen, übergeben Sie den Parameter `redirect=null`.

## Weitere Informationen

### Benachrichtigungen beim Verknüpfen und Aufheben der Verknüpfung durch Nutzer

Wenn ein Nutzer ein soziales Netzwerk verknüpft oder die Verknüpfung aufhebt, können Sie eine Benachrichtigung per Webhook erhalten. Weitere Informationen finden Sie auf der Seite [Social Action Webhooks](/apis/webhooks/actions#social-action).

Sie können auch den [user-Endpoint](/apis/user/profile-details) verwenden, um die verbundenen sozialen Netzwerke eines User Profiles abzurufen.

### Mehrere Sätze sozialer Konten

#### Übersicht

Jedes User Profile verfügt über einen Satz von Social-Media-Konten und kann pro sozialem Netzwerk eine Verbindung herstellen.
Wenn Ihre Nutzer oder Kunden mehrere Sätze von Social-Media-Konten haben – z. B. zwei Facebook-Seiten, zwei Instagram-Konten und zwei YouTube-Kanäle – können Sie diese mehreren Kontosätze mit folgenden Schritten verwalten:

1. **Mehrere User Profiles erstellen** – [Erstellen Sie separate User Profiles](/apis/profiles/create-profile) im Ayrshare-System für jeden Satz sozialer Konten, den Ihr Nutzer oder Kunde verwalten muss.

2. **Eindeutige Profile Keys speichern** – Jedes User Profile hat einen eigenen, eindeutigen Profile Key, der vom Create-User-Profile-Endpoint zurückgegeben wird.

3. **Ihre Profile beschriften** – Vergeben Sie für jedes User Profile einen [Title](/apis/profiles/create-profile#param-title) oder [Tag](/apis/profiles/create-profile#param-tags), um klar zu kennzeichnen, mit welchen Social-Media-Konten sie verknüpft sind (z. B. „Facebook Page A" und „Facebook Page B").

4. **In Ihrer Datenbank zuordnen** – Verknüpfen Sie in Ihrem eigenen System alle relevanten Profile Keys mit dem entsprechenden Nutzer oder Kunden.

5. **Passenden Profile Key verwenden** – Verwenden Sie beim Posten von Inhalten oder beim Abrufen von Analytics für ein bestimmtes soziales Konto den Profile Key, der mit diesem Konto verknüpft ist. Um beispielsweise auf Facebook Page A zu posten, verwenden Sie den Profile Key des User Profiles, das mit Facebook Page A verbunden ist.

#### Beispiel

Betrachten wir ein praktisches Szenario für mehrere Kunden-Konten:

<ul className="custom-bullets">
  <li>**Kunde:** Joe's Restaurant-Kette mit zwei Standorten</li>
</ul>

Joe benötigt separate Social-Media-Konten für jeden Restaurant-Standort:

**Restaurant-Standort 1:**

<ul className="custom-bullets">
  <li>Facebook-Seite: „Joe's Downtown Bistro"</li>
  <li>Instagram: @joesdowntownbistro</li>
  <li>LinkedIn: Joe's Downtown Bistro – Unternehmensseite</li>
</ul>

**Restaurant-Standort 2:**

<ul className="custom-bullets">
  <li>Facebook-Seite: „Joe's Seaside Grill"</li>
  <li>Instagram: @joesseasidegrill</li>
  <li>LinkedIn: Joe's Seaside Grill – Unternehmensseite</li>
</ul>

**Umsetzungslösung:**

1. Erstellen Sie zwei separate User Profiles in Ayrshare:

<ul className="custom-bullets">
  <li>User Profile 1: Titel „Joe's Downtown Bistro Accounts"</li>
  <li>User Profile 2: Titel „Joe's Seaside Grill Accounts"</li>
</ul>

2. Verbinden Sie die passenden sozialen Konten mit jedem Profil:

<ul className="custom-bullets">
  <li>Profil 1: Verknüpft das Facebook, Instagram und LinkedIn des Downtown Bistro</li>
  <li>Profil 2: Verknüpft das Facebook, Instagram und LinkedIn des Seaside Grill</li>
</ul>

3. Speichern Sie beide Profile Keys in Ihrer Datenbank und verknüpfen Sie diese mit Joes Konto:

   ```
   Client: Joe's Restaurant Chain
   - Profile Key 1: abc123... (Downtown location)
   - Profile Key 2: xyz789... (Seaside location)
   ```

4. Wenn Sie ein Menü-Update speziell für den Downtown-Standort posten, verwenden Sie Profile Key 1 in den API-Aufrufen. Wenn Sie eine Fisch-Aktion am Seaside-Standort bewerben, verwenden Sie Profile Key 2.

Indem Sie mehrere User Profiles erstellen, sie mit [Title](/apis/profiles/create-profile#param-title) oder [Tag](/apis/profiles/create-profile#param-tags) passend beschriften und sie in Ihrem System einem einzelnen Nutzer oder Kunden zuordnen, können Sie mit Ayrshare mehrere Social-Media-Konten auf denselben Plattformen verwalten.
Dieser Ansatz ermöglicht ein zielgerichtetes Posten und Analytics-Abrufen für jedes spezifische Konto.

### Nächste Schritte

Weitere Details zur Nutzererfahrung finden Sie hier:

<Card title="User Integration" icon="link" href="/multiple-users/user-integration" horizontal />

Sobald Ihr Nutzer seine Social-Media-Verknüpfungen eingerichtet hat, können Sie in seinem Namen mit
den /post- und /profile-Endpoints Beiträge veröffentlichen.

<Card title="Post API" icon="code" href="/apis/post/overview" horizontal />

<Card title="Profiles API" icon="code" href="/apis/profiles/overview" horizontal />