Skip to main content

Generar una API Key

Para utilizar la API de Locate necesitas una API Key. Esta se envía en la cabecera Authorization de cada solicitud.

Paso 1: Inicia sesión

Ingresa a la plataforma de Locate en locatebyteli.com con tus credenciales.

Paso 2: Accede a la configuración de Desarrolladores

Tienes dos formas de llegar:
  1. Haz clic en tu nombre en la esquina superior derecha
  2. Selecciona Configuración
  3. En el menú lateral, haz clic en Desarrolladores
Menú de usuario mostrando la opción Configuración
Menú lateral mostrando la opción Desarrolladores

Paso 3: Crea una nueva API Key

Haz clic en el botón Nueva API Key. Se abrirá un formulario con las siguientes opciones:
Formulario de creación de API Key
1

Nombre

Asigna un nombre descriptivo que identifique la integración (ej: “CRM Ventas”, “App Flotilla”).
2

Grupos

Selecciona los grupos de dispositivos a los que la API Key tendrá acceso. Solo podrá consultar dispositivos de los grupos seleccionados.
3

Expiración

Define el tiempo de vida de la API Key:
OpciónDuración
7 díasTemporal para pruebas
30 díasCorta duración
60 díasMedia duración
90 díasRecomendado para integraciones
6 mesesLarga duración
1 añoPara integraciones estables
Sin expiraciónNo caduca nunca
Las API Keys sin expiración son menos seguras. Úsalas solo cuando sea estrictamente necesario.
4

Permisos

Selecciona los endpoints que la API Key podrá utilizar. Solo los permisos marcados estarán disponibles.Puedes usar el buscador para filtrar permisos rápidamente.
5

Crear

Haz clic en Crear API Key y copia la clave inmediatamente — no podrás verla de nuevo.
La API Key solo se muestra una vez al momento de crearla. Si la pierdes, deberás generar una nueva.

Paso 4: Usa la API Key en tus solicitudes

Incluye la API Key en la cabecera Authorization con el prefijo Bearer:
curl --request GET \
  --url https://api.locatebyteli.com/devices \
  --header 'Authorization: Bearer lbt_tu_api_key_aqui'

Buenas prácticas

No compartas tu API Key

Cada API Key es personal. Nunca la compartas por correo, chat o la incluyas en código público.

Una API Key por integración

Crea una API Key diferente para cada aplicación o integración. Así puedes revocar una sin afectar las demás.

Almacenamiento seguro

Guarda las API Keys en variables de entorno o un gestor de secretos. Nunca las incluyas directamente en el código fuente.

Rota periódicamente

Regenera tus API Keys de forma periódica para mantener la seguridad de tu cuenta.

Revocar una API Key

Si una API Key fue comprometida o ya no la necesitas:
  1. Ve a ConfiguraciónDesarrolladores
  2. Localiza la API Key en la lista
  3. Haz clic en Eliminar
La API Key dejará de funcionar inmediatamente.