REST API

Authentifizierung und API-Schlüssel

Erstelle einen Schlüssel, wähle seine Scopes aus und sende ihn mit jeder Anfrage mit.

11. Okt. 20261 Min. Lesezeit

Die AeroReply REST API ist unter https://api.aeroreply.com/public/v1 verfügbar. Jede Anfrage wird mit einem API-Schlüssel authentifiziert, der zu einem Workspace gehört.

Einen Schlüssel erstellen

0 von 0 erledigt
  1. Öffne Einstellungen und dann unter Workspace API-Schlüssel
  2. Klicke auf Neuer Schlüssel und vergebe einen Namen, zum Beispiel die App, die ihn verwenden wird
  3. Wähle die Scopes aus. Der Dialog listet die Endpunkte auf, die jeder Scope freischaltet
  4. Klicke auf Schlüssel erstellen und kopiere das Secret. Es wird nur einmal vollständig angezeigt

Scopes

ScopeErlaubt
readPosts, Kontakte und Unterhaltungen auflisten
writeEntwurfs-Posts erstellen

Den Schlüssel senden

Verwende den Header Authorization. Ein x-api-key-Header wird ebenfalls akzeptiert, für Tools, die kein Bearer-Token setzen können.

curl https://api.aeroreply.com/public/v1/me \
  -H "Authorization: Bearer ar_live_…"

GET /me benötigt keinen Scope und ist daher der schnellste Weg, einen Schlüssel zu prüfen. Er gibt den Workspace und die Scopes des Schlüssels zurück.

{
  "workspace": {
    "id": "cml0ws789",
    "name": "Acme Studio"
  },
  "scopes": [
    "read",
    "write"
  ]
}

Schlüssel verwalten

  • Deaktivieren: Schalte einen Schlüssel mit seinem Umschalter aus. Anfragen schlagen fehl, bis du ihn wieder aktivierst.
  • Secret rotieren: Erzeugt ein neues Secret. Das alte funktioniert sofort nicht mehr.
  • Dauerhaft widerrufen: Entfernt den Zugriff endgültig. Das kann nicht rückgängig gemacht werden.

Nur der Owner oder eine benutzerdefinierte Rolle mit Mitglieder verwalten kann Schlüssel erstellen oder ändern. Anfragen werden mit den Berechtigungen der Person ausgeführt, die den Schlüssel erstellt hat.

War das hilfreich?
Markengerechte Beiträge in Minuten veröffentlichen

KI-Inhalte, Planung, Interaktion und eine komplette Marketing-Suite — kostenlos starten.

Kostenlos starten
Zur Dokumentation zurück

Weiterlesen

Setze es in AeroReply in die Praxis um

Alle Tools sind im selben Konto verfügbar, vom kostenlosen Tarif an.

In die Praxis umsetzen

Kostenlos starten – gestalten, planen und wachsen Sie von einem einzigen Workspace aus.

  • Keine Kreditkarte
  • Einrichtung in 2 Minuten
  • Jederzeit kündigen