Eigenen X API-Key einrichten

​

Schritt 1: X Developer Account erstellen

1

Bei der Developer Console anmelden

Gehen Sie zu console.x.com und melden Sie sich mit Ihrem X-Konto an. Weitere Hilfe finden Sie im Getting-Started-Leitfaden von X.

2

Onboarding abschließen

Schließen Sie das Developer-Onboarding ab und akzeptieren Sie das Developer Agreement sowie die zugehörigen Richtlinien.

3

Auf die Console zugreifen

Sie befinden sich nun in der X Developer Console.

​

Schritt 2: Eine App erstellen

1

Zu Apps navigieren

Navigieren Sie in der Developer Console zu Apps.

2

Die App erstellen

Klicken Sie im App-Dashboard auf Create App (siehe X’s App-Setup-Dokumentation für Details). Geben Sie einen App-Namen ein (typischerweise Ihr Markenname). Dieser Name erscheint im OAuth-Autorisierungsbildschirm, wenn Nutzer ihr X-Konto verknüpfen.

3

Umgebung auswählen

Wählen Sie im Dropdown-Menü die Production-Umgebung aus.

4

Das anfängliche Credentials-Popup schließen

X generiert mehrere Zugangsdaten. Ignorieren Sie diese Zugangsdaten und schließen Sie dieses Fenster.

​

Schritt 3: App-Berechtigungen konfigurieren

1

App-Einstellungen öffnen

Suchen Sie unter „Apps” die neue App (aktualisieren Sie die Seite, falls sie nicht erscheint), und klicken Sie darauf, um die Details anzuzeigen.Klicken Sie unter User authentication settings auf Set up.

2

App-Berechtigungen festlegen

Wählen Sie unter App permissions die Option Read and write and Direct message. Dies ist für die vollständige Funktionsunterstützung erforderlich, einschließlich Posten und DMs.

3

App-Typ festlegen

Wählen Sie unter Type of App die Option Web App, Automated App or Bot. Dies ist die richtige Wahl für serverseitige Integrationen wie Ayrshare.

4

Callback- und Website-URLs festlegen

Unter App info:

• Callback URL: Fügen Sie beide der folgenden Callback-URLs hinzu:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

Überspringen Sie diesen Schritt nicht. Diese Callback-URLs sind für den OAuth-Verknüpfungsflow erforderlich. Wenn Ihre Endnutzer die X-Verbindung autorisieren, leitet X sie zu einer dieser URLs zurück, um den Verknüpfungsprozess abzuschließen. Fehlen diese, schlägt der OAuth-Flow mit einem 403 Callback URL not approved-Fehler fehl.

5

Einstellungen speichern

Klicken Sie auf Save. Sie können das OAuth 2.0-Popup ignorieren, da Sie nur 2 der OAuth 1.0-Keys (API Key und API Secret) verwenden werden.

Wichtig: Berechtigungen vor dem Verknüpfen festlegen. Die hier gewählten Berechtigungen bestimmen, was Ihre App tun kann. Wenn Sie die Berechtigungen ändern, nachdem Sie Ihr X-Konto über OAuth verknüpft haben, müssen Sie es erneut verknüpfen, damit das neue Access Token die aktualisierten Berechtigungen erbt.

1. API Key (auch bekannt als Consumer Key, die X-App-Kennung)
2. API Secret (auch bekannt als Consumer Secret)

​

Schritt 4: X-API-Credits kaufen

1

Zur Abrechnung navigieren

Klicken Sie in der Developer Console in der linken Seitenleiste auf Billing → Credits.

2

Credits kaufen

Kaufen Sie Credits (das Minimum beträgt $5, was für Hunderte von API-Aufrufen ausreicht). Jeder API-Aufruf kostet nur einen Bruchteil eines Cents, sodass die Kosten für die meisten Nutzer minimal sein sollten.

3

Auto-Recharge aktivieren

Sie können Auto-Recharge aktivieren, um Unterbrechungen des Dienstes zu vermeiden, und Ihr Spend Cap verwalten, indem Sie einen Höchstbetrag festlegen, den Sie in Ihrem Abrechnungszyklus ausgeben können.

​

Schritt 5: Ihre Ayrshare-API-Aufrufe aktualisieren

1. API Key (auch bekannt als Consumer Key, die X-App-Kennung)
2. API Secret (auch bekannt als Consumer Secret)

​

Header-Referenz

​

Codebeispiele

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

​

Bestehende Profile migrieren (Business & Enterprise)

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

​

Einrichtung überprüfen

​

Wie die X-API-Preise funktionieren

​

Vorteile der Nutzung Ihres eigenen X-API-Keys

• Gebrandete OAuth-Erfahrung: Nutzer sehen Ihren App-Namen und Ihr Branding, wenn sie den X-Zugriff autorisieren.
• Dedizierte Rate Limits: Ihre API-Nutzung wird durch die Limits Ihres eigenen X-Developer-Kontos geregelt, getrennt von anderen Ayrshare-Nutzern. Sie können Ihre Nutzung in der X Developer Console überwachen und die Dokumentation zu X-API-Rate-Limits einsehen.
• Kontrolle über Zugangsdaten: Ihr API Key und API Secret verbleiben in Ihrem eigenen X-Developer-Konto. Ayrshare speichert Ihre geheimen Keys nicht.
• Portabilität: Da sich Nutzer über Ihre X-App authentifizieren, bleibt Ihre Integration vollständig unter Ihrer Kontrolle.
• Nutzungstransparenz: Ihr X-Developer-Dashboard zeigt API-Anfragen, Rate Limits und die Credit-Nutzung an.

​

Sicherheit

• Ihr API Key und API Secret werden nicht von Ayrshare gespeichert.
• Allgemeine Best Practices zur Sicherheit finden Sie im Authentication-Security-Leitfaden von X.

​

FAQ

​

Fehlerbehebung

​

Benötigen Sie Hilfe?