Schnellstart

API-Schlüssel erhalten

1. Einen persönlichen Schlüssel erstellen

Öffnen Sie in der Sofia-App Einstellungen › API, Tab Persönlicher Zugriff, und erstellen Sie einen Schlüssel. Wählen Sie Name, Ablaufdatum und Berechtigungen. Der Schlüssel wird nur einmal angezeigt: Kopieren Sie ihn und bewahren Sie ihn in einem Secret Store auf, nie in Ihrem Code.

2. Den ersten Aufruf senden

Senden Sie den Schlüssel im Header Authorization. GET /v1/me zeigt Ihnen, für wen der Schlüssel handelt, seine Workspaces und seine Berechtigungen.

bash
curl https://api.sofia-post.com/api/v1/me \
  -H "Authorization: Bearer $SOFIA_API_KEY"
json
{
  "tokenType": "personal_key",
  "user": { "id": "cmo7qiltc0000sb1p7zdx1aw4" },
  "coverage": "account",
  "workspaces": [{ "id": "cmo7qiltc0000sb1p7zdx1aw4", "name": "160 food" }],
  "scopes": ["establishments:read", "posts:read", "posts:write"],
  "mode": "live",
  "expiresAt": "2026-11-09T20:09:05.644Z"
}

3. Ihre Betriebe auflisten

Jeder Beitrag gehört zu einem Betrieb. Notieren Sie sich die id des Betriebs, für den Sie veröffentlichen möchten.

bash
curl https://api.sofia-post.com/api/v1/establishments \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Nächste Schritte

Sie sind bereit für Ihren ersten Beitrag. Um einen beliebigen Endpoint im Browser auszuprobieren, öffnen Sie die API-Referenz und klicken Sie auf Ausprobieren.