La API de Locate permite gestionar cuentas, usuarios, grupos, dispositivos, telemetría y métodos de pago.
URL Base
https://api.locatebyteli.com
Autenticación
Todos los endpoints requieren autenticación mediante API Key en la cabecera Bearer:
Authorization: Bearer lbt_••••••••••••••••••••
Puedes generar tu API Key desde Configuración → Desarrolladores en la plataforma.
Control de Acceso
- Por grupos: Los grupos del usuario se cruzan con los grupos asignados al dispositivo
- Por enlace compartido: Si es un enlace de share, se filtran dispositivos por los IDs permitidos
- Por cuenta: Algunos endpoints validan que la cuenta del usuario coincida con el recurso
Jerarquía de Cuentas
| Tipo | Descripción | Permisos |
|---|
| Root | Cuenta administradora principal | Puede crear cualquier tipo de cuenta |
| Partner | Distribuidor | Puede crear solo cuentas tipo customer |
| Customer | Cliente final | No puede crear subcuentas |
Códigos de Error HTTP
| Código | Significado |
|---|
200 | Operación exitosa |
400 | Parámetros inválidos o mal formateados |
401 | No autorizado / Cuenta ya verificada |
403 | Prohibido (ej: email duplicado, eliminar usuario propio) |
404 | Recurso no encontrado |
408 | Timeout |
409 | Conflicto (recurso ya existe) |
500 | Error interno del servidor |
502 | Error de servicio externo |
503 | Servicio no disponible |
504 | Timeout en la consulta |
