> ## 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.

# Quick-Start-Anleitung

> Verknüpfen Sie Ihre Social-Media-Konten und senden Sie in wenigen Minuten Ihren ersten Beitrag.

Diese Anleitung ist für die Einrichtung eines einzelnen Unternehmens gedacht. Für Abonnements des Business Plan und des Enterprise Plan mit mehreren Nutzern wird eine personalisierte Integrationsanleitung bereitgestellt.

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/HaWh_QOib_Y" title="Ayrshare's Social API Quick Start Guide" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscsope; picture-in-picture" />
</div>

## Ihre Social-Media-Konten verbinden

Melden Sie sich bei einem [Ayrshare-Konto](https://app.ayrshare.com/) an oder registrieren Sie sich.
Klicken Sie auf der Social-Account-Seite auf die sozialen Netzwerke, die Sie verbinden möchten.
Bitte erteilen Sie alle Berechtigungen.

<p align="center">
  <img width="240" src="https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/fb-connect.webp?fit=max&auto=format&n=dKBti0xVDJrOZ19f&q=85&s=d256f4862cb21b388d388cc62aa94659" alt="Facebook Linking Example" data-path="images/fb-connect.webp" />
</p>

## Ihren API Key abrufen

Ein API Key ist erforderlich, um den Zugriff auf die API-Endpunkte zu autorisieren.
Dieser Schlüssel wird im Header Ihrer Anfragen verwendet und muss mit dem Schlüsselwort `Bearer` versehen sein.

Ihr API Key befindet sich im [Ayrshare-Dashboard](https://app.ayrshare.com/) auf der Seite **API Key**. Wechseln Sie bei Bedarf über die Seite **User Profiles** zu Ihrem 'Primary Profile'.
Von dort finden Sie die Seite **API Key** in der linken Seitenleiste.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/api-key.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=29ebd3dd2f23c9f9f1c52a974ebd6240" alt="API Key" width="4000" height="1126" data-path="images/api-key.webp" />

Jeder API-Aufruf muss den API Key als `Bearer`-Token im Header enthalten. Fügen Sie außerdem den `Content-Type` `application/json` hinzu.

```json Header theme={"system"}
"Authorization": "Bearer API_KEY",
"Content-Type": "application/json"
```

Weitere Informationen finden Sie unter [Authorization](/apis/overview#authorization).

## Ihren ersten API-Beitrag senden

### Den Beitrag veröffentlichen

Im Folgenden finden Sie Code-Beispiele, die zeigen, wie Sie mit unserer API in verschiedenen Programmiersprachen einen Beitrag erstellen.
Für eine noch einfachere Integration können Sie eines unserer vorgefertigten [SDK-Pakete](/packages-guides/overview) verwenden.

Um einen Beitrag zu erstellen, benötigen Sie:

<ul className="custom-bullets">
  <li>Ihren [API Key](/apis/overview#authorization) zur Authentifizierung.</li>
  <li>Den Textinhalt Ihres Beitrags.</li>
  <li>Die sozialen Netzwerke, auf denen Sie posten möchten (nur Plattformen, die Sie verknüpft haben).</li>
  <li>Optional: URLs von Bildern oder Videos, die Sie einbinden möchten.</li>
</ul>

Alle Beispiele verwenden den Endpunkt [/post](/apis/post/post). Sehen wir uns einige Beispiele an:

<Info>
  **Posten Sie auf X/Twitter?** X erfordert Ihre eigenen API-Anmeldedaten. Fügen Sie 2 BYO-Header (`X-Twitter-OAuth1-Api-Key` und `X-Twitter-OAuth1-Api-Secret`) zu Ihrer Anfrage hinzu. Dies ist eine **einmalige Einrichtung pro Ayrshare-Konto**, und dasselbe Schlüsselpaar funktioniert für jedes Sub-Profil bzw. jeden Endnutzer. Details finden Sie in der [Einrichtungsanleitung](/dashboard/connect-social-accounts/x-twitter-byo-keys).
</Info>

<CodeGroup>
  ```bash cURL theme={"system"}
  curl \
  -H "Authorization: Bearer API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "post": "Today is a great day!",
    "platforms": ["facebook", "instagram", "linkedin"],
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
  }' \
  -X POST https://api.ayrshare.com/api/post
  ```

  ```javascript JavaScript theme={"system"}
  const API_KEY = "API_KEY";

  fetch("https://api.ayrshare.com/api/post", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": `Bearer ${API_KEY}`
        },
        body: JSON.stringify({
          post: "Today is a great day!", // required
          platforms: ["bluesky", "facebook", "instagram", "linkedin"], // required
          mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"] //optional
        }),
      })
        .then((res) => res.json())
        .then((json) => console.log(json))
        .catch(console.error);
  ```

  ```python Python theme={"system"}
  import requests

  payload = {'post': 'Today is a great day!',
          'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin'],
          'mediaUrls': ['https://img.ayrshare.com/012/gb.jpg']}
  headers = {'Content-Type': 'application/json',
          'Authorization': 'Bearer API_KEY'}

  r = requests.post('https://api.ayrshare.com/api/post',
      json=payload,
      headers=headers)

  print(r.json())
  ```

  ```php PHP theme={"system"}
  <?php

  $curl = curl_init();
  $data = [
      "post" => "Today is a great day!",
      "platforms" => ["bluesky", "facebook", "instagram", "linkedin", "pinterest"],
      "mediaUrls" => ["https://img.ayrshare.com/012/gb.jpg"]
  ];

  curl_setopt_array($curl, [
      CURLOPT_URL => 'https://api.ayrshare.com/api/post',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_POST => true,
      CURLOPT_POSTFIELDS => json_encode($data),
      CURLOPT_HTTPHEADER => [
          'Authorization: Bearer API_KEY', // Replace 'API_KEY' with your actual API key
          'Content-Type: application/json'
      ],
  ]);

  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;
  ```

  ```go Go theme={"system"}
  package main

  import (
  	"bytes"
  	"encoding/json"
  	"log"
  	"net/http"
  )

  func main() {
  	message := map[string]interface{}{
  		"post":      "Today is a great day!",
  		"platforms": []string{"bluesky", "facebook", "instagram", "linkedin"},
  		"mediaUrls": []string{"https://img.ayrshare.com/012/gb.jpg"}
  	}

  	bytesRepresentation, err := json.Marshal(message)
  	if err != nil {
  		log.Fatalln(err)
  	}

  	req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/post",
  		bytes.NewBuffer(bytesRepresentation))

  	req.Header.Add("Content-Type", "application/json; charset=UTF-8")
  	req.Header.Add("Authorization", "Bearer API_KEY")

  	res, err := http.DefaultClient.Do(req)
  	if err != nil {
  		log.Fatal("Error:", err)
  	}

  	res.Body.Close()
  }
  ```

  ```csharp C# theme={"system"}
  using System;
  using System.Net.Http;
  using System.Text;
  using System.Threading.Tasks;

  namespace PostPOSTRequest_csharp
  {
    class Post
    {
      private static readonly HttpClient client = new HttpClient();

          static async Task Main(string[] args)
          {
              string API_KEY = "API_KEY";
              string url = "https://api.ayrshare.com/api/post";

              // Set up request headers
              client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

              // Prepare JSON content
              string json = "{\"post\" : \"Today is a great day!\","
                  + "\"platforms\" : [ \"bluesky\", \"facebook\", \"instagram\", \"linkedin\" ],"
                  + "\"mediaUrls\" : [ \"https://img.ayrshare.com/012/gb.jpg\" ]}";
              var content = new StringContent(json, Encoding.UTF8, "application/json");

              try
              {
                  // Send POST request
                  HttpResponseMessage response = await client.PostAsync(url, content);
                  response.EnsureSuccessStatusCode();

                  // Read response
                  string responseBody = await response.Content.ReadAsStringAsync();
                  Console.WriteLine(responseBody);
              }
              catch (HttpRequestException e)
              {
                  Console.WriteLine($"Error: {e.Message}");
              }
          }
      }
  }
  ```

  ```ruby Ruby theme={"system"}
  require 'httparty'    # gem install httparty

  res = HTTParty.post("https://api.ayrshare.com/api/post",
      headers: {Authorization: "Bearer API_KEY"},
      body: {
          post: "Today is a great day!",
          platforms: ['bluesky', 'facebook', 'instagram', 'linkedin'],
          mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"]
      }).body

  puts res
  ```
</CodeGroup>

Glückwunsch! Sie haben soeben Ihren ersten Beitrag gesendet.

### Antwort auf den Beitrag

Sie erhalten eine Antwort mit einem `status` von "success", sobald unsere API Ihren Beitrag erfolgreich verarbeitet hat. Die Antwort enthält:

<ul className="custom-bullets">
  <li>`status`: Gesamtstatus des API-Aufrufs ("success" oder "error")</li>
  <li>`errors`: Array etwaiger aufgetretener Fehler (leer bei Erfolg)</li>
  <li>`postIds`: Array von Objekten mit plattformspezifischen Details:</li>

  <ul className="custom-bullets">
    <li>Name der Plattform</li>
    <li>Beitrags-ID auf dieser Plattform</li>
    <li>URL zum Anzeigen des Beitrags</li>
    <li>Weitere plattformspezifische Informationen</li>
  </ul>
</ul>

Jede Plattform im `postIds`-Array hat ihren eigenen Status, sodass Sie überprüfen können, welche Plattformen Ihren Beitrag erfolgreich empfangen haben.

Prüfen Sie Ihre Social-Media-Seiten, um sicherzustellen, dass der Beitrag erfolgreich verarbeitet wurde und live ist. Beachten Sie, dass es bei einigen Plattformen eine leichte Verzögerung geben kann, bis Beiträge öffentlich erscheinen.

Hier ist eine Beispielantwort:

```json Post Response theme={"system"}
{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "id": "738681876342836_1530521371228093",
      "postUrl": "https://www.facebook.com/738681876342836/posts/1530521371228093",
      "platform": "facebook"
    },
    {
      "status": "success",
      "id": "18008340650526653",
      "postUrl": "https://www.instagram.com/p/DGf4hgZObR0/",
      "usedQuota": 1,
      "platform": "instagram"
    },
    {
      "status": "success",
      "id": "urn:li:share:7300150903578275840",
      "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7300150903578275840",
      "owner": "urn:li:organization:66755239",
      "platform": "linkedin"
    }
  ],
  "id": "K0DmYRgugS5P694it",
  "refId": "d93ca2784c9bf7bf83e0bf081d16c91598",
  "post": "Today is a great day!"
}
```

Weitere Code-Beispiele für den Aufruf der Social Media API in Node.js, Python, PHP, Golang, C# und Ruby sowie weitere großartige Funktionen finden Sie hier:

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

### Ein wenig tiefer eintauchen

Sehen wir uns Schritt für Schritt an, was bei diesem API-Aufruf passiert ist.

<Steps>
  <Step title="Header festlegen">
    Wir haben den Header „Authorization Bearer Token" (API Key) und den Content-Type
    json gesetzt.
  </Step>

  <Step title="Body-Objekt erstellen">
    Anschließend haben wir ein Body-Objekt erstellt:

    <ul className="custom-bullets">
      <li>Beitrag mit dem Text „Today is a great day!".</li>

      <li>
        Soziale Netzwerke Facebook, Instagram und LinkedIn.
        Sie sollten nur die Plattformen einbeziehen, die Sie auf der Social-Linkage-
        Seite verknüpft haben.
      </li>

      <li>Bild in den mediaUrls hinzugefügt.</li>
    </ul>
  </Step>

  <Step title="Den /post-Endpunkt aufrufen">
    Alles als HTTP POST an den /post-Endpunkt gesendet.
  </Step>
</Steps>

## Bevor Sie loslegen – einige Best Practices

### Lesen Sie die Dokumentation

Wir pflegen eine umfangreiche und aktuelle Dokumentation. Da Sie bereits hier sind, nehmen Sie sich etwas Zeit, um die Abschnitte der Dokumentation in der linken Navigation zu erkunden.

### Fehlercodes sind wichtig

Sie müssen sie behandeln, damit Ihre Nutzer eine großartige Erfahrung haben.

<Card title="Fehler" icon="link" href="/errors/overview" horizontal />

### Bewahren Sie Ihren API Key sicher auf

Wir nehmen Sicherheit sehr ernst – und Sie sollten das auch tun. Sie haben die volle Kontrolle über die Verbindung zwischen Ayrshare und Ihren Social-Media-Konten. Sobald die Konten verbunden sind, wird der Ayrshare API Key zu Ihrem Authentifizierungsmittel. Bitte bewahren Sie diesen Schlüssel geheim und sicher auf.

### Veröffentlichen Sie Testbeiträge

Sie können Testbeiträge mit einem zufälligen Zitat, Bild oder Video veröffentlichen, indem Sie die Parameter `randomPost`, `randomMediaUrl` und `isLandscapeVideo` oder `isPortraitVideo` im [/post-Endpunkt](/apis/post/post) verwenden. Wenn Sie `randomPost` verwenden, ist der Parameter `post` nicht erforderlich.

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/hMI0eK-5qBk?si=y5dkygosZ1B2DtlV" title="Post Random Content" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />
</div>

<Warning>
  Diese Beiträge werden live auf Ihren Social-Media-Seiten veröffentlicht. Löschen Sie sie daher gegebenenfalls nach dem Testen.
</Warning>

#### Zufälliges Zitat

Senden Sie ein zufälliges Zitat zum Testen der Beitragsveröffentlichung, indem Sie `randomPost: true` hinzufügen.

Wird mit dem [/post](/apis/post/post)-Endpunkt verwendet.

```json theme={"system"}
"randomPost": true
```

#### Zufälliges Bild

Senden Sie ein zufälliges Bild, indem Sie `randomMediaUrl: true` hinzufügen.

Wird mit dem [/post](/apis/post/post)-Endpunkt verwendet.

```json theme={"system"}
"randomMediaUrl": true
```

#### Zufälliges Video

Senden Sie ein zufälliges Landscape-Video, indem Sie `isVideo: true` und `isLandscapeVideo: true` hinzufügen.
Das Video hat die standardmäßige Landscape-Größe.

Wird mit dem [/post](/apis/post/post)-Endpunkt verwendet.

```json theme={"system"}
"randomMediaUrl": true,
"isLandscapeVideo": true
```

Senden Sie ein zufälliges Portrait-Video – erforderlich für TikTok oder Facebook-/Instagram-Reels –, indem Sie `isVideo: true` und `isPortraitVideo: true` hinzufügen.

Wird mit dem [/post](/apis/post/post)-Endpunkt verwendet.

```json theme={"system"}
"randomMediaUrl": true,
"isPortraitVideo": true
```

#### Zufälliger Kommentar

Senden Sie einen zufälligen Kommentar zum Testen der Kommentarveröffentlichung, indem Sie `randomComment: true` hinzufügen.

Wird mit dem [/comment](/apis/comments/post-comment)-Endpunkt verwendet.

```json theme={"system"}
"randomComment": true
```

#### Beispiel-cURL-Aufruf

Senden Sie ein zufälliges Zitat und ein Portrait-Video.

```bash theme={"system"}
curl \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
    "randomPost": true,
    "platforms": ["facebook", "instagram", "linkedin"],
    "randomMediaUrl": true,
    "isPortraitVideo": true
}' \
https://api.ayrshare.com/api/post
```

### **Testen Sie Ihre API-Aufrufe mit Postman**

[Postman](https://www.postman.com/) ist ein hervorragendes Tool zum Testen von API-Aufrufen. Sie können sogar Code in über einem Dutzend Sprachen generieren.

### Demo-Code

Wenn Sie ein Beispielprojekt in React und Node.js suchen, sehen Sie sich dieses GitHub-Repository an:

<Card title="Github Social Posting Demo App" icon="github" href="https://github.com/ayrshare/social-api-demo" horizontal />

### **Häufige Probleme**

Manchmal läuft nicht alles nach Plan, daher finden Sie hier etwas Hilfe in unserem Help Center.

<Card title="Fehlerbehebung" icon="link" href="/help-center/overview" horizontal />

### **Kontaktieren Sie uns**

Wir helfen Ihnen gerne. Nutzen Sie den Chat in der rechten unteren Ecke oder [schreiben Sie uns eine E-Mail](mailto:support@ayrshare.com).