api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/workspacesZwraca 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 roboczegoflow_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 witrynyflow_ 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
| Parametr | Typ | Opis |
|---|---|---|
id | string | ID obszaru roboczego. Wysłane w nagłówku X-Workspace-Id pozwala działać w tym obszarze. |
name | string | Nazwa obszaru roboczego. |
organization.id | string | ID organizacji będącej właścicielem obszaru roboczego. |
organization.name | string | Nazwa organizacji będącej właścicielem obszaru roboczego. |
role.key | string | Rola w tym obszarze roboczym: admin lub editor, czyli role z dostępem do Flowsery. |
role.name | string | Wyświetlana nazwa roli. |
permissions | string[] | Klucze uprawnień w tym obszarze roboczym, np. flowsery.write. |
isDefault | boolean | True dla obszaru roboczego, do którego trafia wywołanie bez nagłówka X-Workspace-Id. |
current | boolean | True 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
}
]
}