Kim jestem
Odczytaj rolę, obszar roboczy i dokładną listę uprawnień klucza API, którego używasz, aby klient lub agent wiedział, co może zrobić, zanim spróbuje.
https://post.adaptlypost.com/post/api/v1/meZwraca klucz użyty w wywołaniu: jego typ, nazwę, obszar roboczy, rolę, efektywne uprawnienia i datę wygaśnięcia. Może go wywołać każdy ważny klucz, niezależnie od roli.
Kiedy wywoływać
Warto wywołać go raz przy starcie integracji i ponownie po błędzie 403, aby sprawdzić, co klucz może w danej chwili. Odpowiedź jest obliczana przy każdym wywołaniu na podstawie roli klucza i aktualnej roli jego twórcy, więc zmienia się, gdy tylko administrator zmieni którąś z nich.
Pola odpowiedzi
| Pole | Opis |
|---|---|
tokenType | api_token dla klucza ze strony API i agenci AI, oauth dla sesji MCP lub OAuth. |
tokenId | ID klucza widoczne na stronie API i agenci AI. Null dla sesji OAuth. |
tokenName | Nazwa nadana kluczowi przy tworzeniu. Null dla sesji OAuth. |
workspace | Obszar roboczy, w którym działa to wywołanie. Klucz API jest powiązany z jednym obszarem roboczym. Sesja OAuth działa w swoim domyślnym obszarze roboczym, chyba że X-Workspace-Id wskazuje inny. |
organizationId | Organizacja będąca właścicielem obszaru roboczego. |
role | Rola, z którą działa klucz: key to admin, editor, contributor lub viewer; name to etykieta w języku użytkownika. |
issuerRole | Aktualna rola członka, który utworzył klucz. Klucz nigdy nie ma większych uprawnień niż ten członek. Null dla sesji OAuth. |
permissions | Wszystkie uprawnienia klucza w tej chwili, po uwzględnieniu aktualnej roli twórcy. Można je porównać z uprawnieniem podanym na stronie każdego endpointu. |
can | Trzy wartości logiczne, draft, schedule i publish, dla trzech działań na postach najczęściej wykonywanych przez integracje. |
summary | Jedno zdanie w języku użytkownika, podające rolę i jej możliwości. Przeznaczone do interfejsu lub transkrypcji agenta. |
expiresAt | Moment, w którym klucz przestaje działać. Null oznacza, że nigdy nie wygasa. |
Odpowiedź jest aktualna
Żadna z tych wartości nie jest zapisana w kluczu. Pole permissions jest przeliczane przy każdym żądaniu na podstawie roli wybranej przy tworzeniu i bieżącej roli twórcy, czyli tak samo, jak robi to każdy inny endpoint przed przyjęciem żądania. To, co /me podaje jako możliwości klucza, dokładnie odpowiada temu, na co pozwoli API.
curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/me \
--header 'Authorization: Bearer <api-key>'{
"tokenType": "api_token",
"tokenId": "tok_01j9x4k2",
"tokenName": "Zapier drafts",
"workspace": { "id": "ag_01j9x" },
"organizationId": "org_01hzq",
"role": { "key": "contributor", "name": "Contributor" },
"issuerRole": "editor",
"permissions": [
"workspace.read",
"posts.read",
"accounts.read",
"posts.draft",
"media.upload",
"analytics.read",
"ai.generate",
"members.read",
"tokens.own"
],
"can": { "draft": true, "schedule": false, "publish": false },
"summary": "This key acts as Contributor in this workspace and can create drafts, but cannot schedule or publish them.",
"expiresAt": null
}