Quién soy
Lee el rol, el espacio de trabajo y la lista exacta de permisos de la clave de API con la que llamas, para que un cliente o un agente sepa qué puede hacer antes de intentarlo.
https://post.adaptlypost.com/post/api/v1/meDevuelve la clave con la que llamas: su tipo, nombre, espacio de trabajo, rol, permisos efectivos y caducidad. Cualquier clave válida puede llamarlo, sea cual sea su rol.
Cuándo llamarlo
Llámalo una vez al arrancar una integración, y de nuevo tras un 403, para saber qué puede hacer la clave ahora mismo. La respuesta se calcula en cada llamada a partir del rol de la clave y el rol actual de su creador, así que cambia en el momento en que un administrador cambia cualquiera de los dos.
Campos de la respuesta
| Campo | Descripción |
|---|---|
tokenType | api_token para una clave de la página Tokens de API, oauth para una sesión MCP u OAuth. |
tokenId | El ID de la clave tal como aparece en la página Tokens de API. Null en una sesión OAuth. |
tokenName | El nombre dado a la clave al crearla. Null en una sesión OAuth. |
workspace | El espacio de trabajo en el que actúa la clave. Una clave está ligada a un solo espacio de trabajo. |
organizationId | La organización propietaria del espacio de trabajo. |
role | El rol con el que actúa la clave: key es admin, editor, contributor o viewer; name es la etiqueta en tu idioma. |
issuerRole | El rol actual del miembro que creó la clave. La clave nunca tiene más que este miembro. Null en una sesión OAuth. |
permissions | Cada permiso que la clave tiene ahora mismo, una vez aplicado el rol actual del creador. Compáralo con el permiso indicado en cada página de endpoint. |
can | Tres booleanos, draft, schedule y publish, para las tres cosas que la mayoría de integraciones hacen con las publicaciones. |
summary | Una frase, en tu idioma, que nombra el rol y lo que puede hacer. Pensada para una interfaz o la transcripción de un agente. |
expiresAt | Cuándo deja de funcionar la clave. Null significa que nunca caduca. |
La respuesta es en vivo
Nada de esto se guarda en la clave. permissions se recalcula en cada solicitud a partir del rol elegido al crearla y del rol del creador en ese momento, el mismo cálculo que ejecuta cualquier otro endpoint antes de aceptar una solicitud. Lo que /me dice que puede hacer una clave es exactamente lo que la API le permitirá.
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
}