api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/workspaces

Zwraca listę obszarów roboczych, w których mogą działać te dane uwierzytelniające. Zwrócony identyfikator wysłany w nagłówku X-Workspace-Id uruchamia dowolne inne żądanie w tym obszarze.

Bearer token (token API obszaru roboczego lub logowanie OAuth)

Kto widzi które obszary robocze

Logowanie OAuth, np. przez konektor Claude lub ChatGPT, daje dostęp do wszystkich obszarów roboczych członka, także w różnych organizacjach. Token API obszaru roboczego flow_ws_ ma dostęp tylko do własnego obszaru, więc lista ma jedną pozycję. current oznacza obszar, w którym wykonano to wywołanie. Na liście są tylko obszary z uprawnieniem flowsery.write, czyli role Administrator i Edytor.

Klucze witryn otrzymują 400

Klucz API witryny flow_ jest przypisany do jednej witryny i nie stoi za nim żaden członek, dlatego ten punkt końcowy zwraca 400 Bad Request. Należy użyć tokena API obszaru roboczego lub logowania OAuth.

Pola odpowiedzi

ParametrTypOpis
idstringID obszaru roboczego. Wysłane w nagłówku X-Workspace-Id pozwala działać w tym obszarze.
namestringNazwa obszaru roboczego.
organization.idstringID organizacji będącej właścicielem obszaru roboczego.
organization.namestringNazwa organizacji będącej właścicielem obszaru roboczego.
role.keystringRola w tym obszarze roboczym: admin lub editor, czyli role z dostępem do Flowsery.
role.namestringWyświetlana nazwa roli.
permissionsstring[]Klucze uprawnień w tym obszarze roboczym, np. flowsery.write.
isDefaultbooleanTrue dla obszaru roboczego, do którego trafia wywołanie bez nagłówka X-Workspace-Id.
currentbooleanTrue dla obszaru roboczego, w którym wykonano to wywołanie.
Przykładowe żądanie (curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/workspaces \
  --header 'Authorization: Bearer <workspace-api-token>'
200
{
  "status": "success",
  "data": [
    {
      "id": "cm8ws1a2b3",
      "name": "Acme marketing",
      "organization": { "id": "org_01J8ZK4M2Q", "name": "Acme" },
      "role": { "key": "editor", "name": "Editor" },
      "permissions": [
        "workspace.read",
        "posts.read",
        "accounts.read",
        "posts.draft",
        "media.upload",
        "analytics.read",
        "ai.generate",
        "members.read",
        "tokens.own",
        "posts.others",
        "posts.schedule",
        "posts.publish",
        "posts.delete",
        "analytics.sync",
        "webhooks.read",
        "webhooks.manage",
        "signature.manage",
        "flowsery.write",
        "redreplier.write",
        "claw.use"
      ],
      "isDefault": true,
      "current": true
    },
    {
      "id": "cm8ws4c5d6",
      "name": "Northwind",
      "organization": { "id": "org_01J9P7T3XB", "name": "Northwind Studio" },
      "role": { "key": "admin", "name": "Admin" },
      "permissions": [
        "workspace.read",
        "workspace.manage",
        "posts.read",
        "posts.draft",
        "posts.others",
        "posts.schedule",
        "posts.publish",
        "posts.delete",
        "media.upload",
        "accounts.read",
        "accounts.manage",
        "analytics.read",
        "analytics.sync",
        "ai.generate",
        "members.read",
        "members.manage",
        "tokens.own",
        "tokens.manage",
        "webhooks.read",
        "webhooks.manage",
        "signature.manage",
        "flowsery.write",
        "redreplier.write",
        "claw.use"
      ],
      "isDefault": false,
      "current": false
    }
  ]
}