Saltar al contenido
API v1 · https://bentho.ai/api
GET/profile

Qué 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

CAMPOTIPOQUÉ ES
successboolSiempre true si la clave vale.
user.emailstringEl email de quien creó la clave.
user.namestringSu nombre.
user.rolestringEl rol de esa cuenta. Una clave nunca administra, sea cual sea el rol.
user.companiesstring[]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": …}

STATUSCUÁNDODETAIL LITERAL
401Clave inexistente, mal formada o revocadaCredencial de servicio inválida o revocada.
401Sin cabecera AuthorizationNo 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.