Skip to main content
POST
/
devices
/
share
Crear enlace compartido
curl --request POST \
  --url https://api.locatebyteli.com/devices/share \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "devices": [
    "<string>"
  ],
  "ttl": 123
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "token": "a1b2c3d4e5f6",
  "devices": ["770e8400-e29b-41d4-a716-446655440000", "880e8400-e29b-41d4-a716-446655440000"],
  "expires_at": "2026-03-18T11:00:00Z",
  "original_url": "https://app.locatebyteli.com/share?token=eyJhbGciOiJIUzI1NiJ9...",
  "short_url": "https://locate.link/abc123"
}

​
Authorization

​
Authorization
string
default:"Bearer "
required
API Key. Formato: Bearer lbt_•••

​
Body Parameters

​
devices
string[]
required
UUIDs de los dispositivos a compartir (mínimo 1)
​
ttl
integer
required
Tiempo de vida del enlace en segundos (mínimo 60)

​
Respuesta

​
id
uuid
ID del enlace creado
​
token
string
Token aleatorio del enlace
​
devices
string[]
Lista de IDs de dispositivos compartidos
​
expires_at
datetime
Fecha de expiración del enlace
​
original_url
string
URL completa con token de compartición
​
short_url
string
URL acortada

​
Comportamiento

  • Valida que todos los dispositivos pertenezcan a los grupos del usuario.
  • Genera un token aleatorio.
  • Calcula la fecha de expiración: now + ttl segundos.
  • Genera URLs larga y corta.
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "token": "a1b2c3d4e5f6",
  "devices": ["770e8400-e29b-41d4-a716-446655440000", "880e8400-e29b-41d4-a716-446655440000"],
  "expires_at": "2026-03-18T11:00:00Z",
  "original_url": "https://app.locatebyteli.com/share?token=eyJhbGciOiJIUzI1NiJ9...",
  "short_url": "https://locate.link/abc123"
}

​
Errores

CódigoDescripción
400Parámetros inválidos
404Dispositivo no encontrado o sin acceso
500Error interno