GET
/profileQué puede hacer tu clave
De quién es la clave, a qué espacios llega y si puede escribir. Sirve para comprobar una clave nueva antes de usarla. Va sin /api delante.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| success | bool | Siempre true si la clave vale. |
| user.email | string | El email de quien creó la clave. |
| user.name | string | Su nombre. |
| user.role | string | El rol de esa cuenta. Una clave nunca administra, sea cual sea el rol. |
| user.companies | string[] | Los espacios a los que llega la clave en esta petición: los que nombró al crearla y su dueño sigue teniendo. Si se creó sin espacios, todos los de su dueño. |
| user.permiso | "lee" | "escribe" | El más restrictivo entre el de la clave y el de su dueño. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 401 | Clave inexistente, mal formada o revocada | Credencial de servicio inválida o revocada. |
| 401 | Sin cabecera Authorization | No autenticado. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Si a su dueño le quitan un espacio, la clave lo pierde en la siguiente petición, sin revocarla: esta respuesta lo refleja.
- No tiene en cuenta la configuración de API de cada espacio: un espacio con la API apagada o con lista de IPs sigue saliendo aquí, aunque sus rutas te respondan 403.