Arbeitsbereiche auflisten: GET /workspaces

A kulcs által elérhető munkaterületek. A `current` azt jelöli, amelyikre a kérés érkezett. Ha a kulcs több munkaterületre szól, a többi útvonal a `showorg` fejlécben várja a munkaterület azonosítóját.

Der Pfad

Die Arbeitsbereiche, die dieser Zugang erreicht: ID, Name, die Rolle des Schlüsselinhabers dort, und `current` markiert den, auf den diese Anfrage ging.

Ein Schlüssel kann mehrere Arbeitsbereiche umfassen. Jede andere Route erwartet dann die ID des gewählten Arbeitsbereichs im Header `showorg` und antwortet ohne ihn mit 403, statt zu raten. Diese eine Route funktioniert auch ohne Header, damit es etwas zum Auswählen gibt. In der Befehlszeile tun `posty workspaces:list` und `posty workspaces:use <id>` dasselbe.

Anfrage

curl https://api.posty.hu/public/v1/workspaces \
  -H "Authorization: psty_a_kulcsod"

Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im OpenAPI-Dokument.

[
  { "id": "org_1a2b3c", "name": "Kávézó Kft.", "role": "SUPERADMIN", "current": true },
  { "id": "org_4d5e6f", "name": "Personal", "role": "ADMIN", "current": false }
]

Siehe auch

• Authentifizierung: der Schlüssel und die Scopes.
• Fehler und Limits: die Fehlerantworten und das Aufruflimit.
• Alle Endpunkte: die vollständige Liste.