Obtener todos los dispositivos GET
Obtén una lista de todos los dispositivos registrados en tu cuenta.
Endpoint
GET https://api.pocketalert.app/v1/devicesAutenticación
Obligatorio
Incluye uno de estos encabezados en tu solicitud:
Token: <your-api-key>— Obtenla en Claves de APIAuthorization: Bearer <jwt-token>— Desde Iniciar sesión
Solicitud
Encabezados
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Token | ✅ | Tu clave de API |
Authorization | ✅ | Bearer <jwt-token> |
Ejemplo de solicitud
bash
curl -X GET "https://api.pocketalert.app/v1/devices" \
-H "Token: your-api-key"javascript
const response = await fetch('https://api.pocketalert.app/v1/devices', {
headers: { 'Token': 'your-api-key' }
});
const devices = await response.json();python
import requests
response = requests.get(
'https://api.pocketalert.app/v1/devices',
headers={'Token': 'your-api-key'}
)
print(response.json())php
$response = Http::withHeaders([
'Token' => 'your-api-key',
])->get('https://api.pocketalert.app/v1/devices');
return $response->json();Respuesta
Respuesta correcta
200 OK
Devuelve un array de objetos de dispositivo
| Campo | Tipo | Descripción |
|---|---|---|
tid | string | Identificador único del dispositivo |
name | string | Nombre del dispositivo |
serial_number | string | Número de serie del dispositivo |
is_active | boolean | Indica si el dispositivo está activo |
created_at | string | Marca de tiempo del registro |
json
[
{
"tid": "9dc24hqldvv2bfx2nlc6r",
"name": "iPhone 15 Pro",
"serial_number": "123456-OK91-KLAI-8K91-32A0AKSA28X2",
"is_active": true,
"created_at": "12.06.2023 02:48:49"
},
{
"tid": "qjxozlq7xr7fakrjplj193",
"name": "Android Tablet",
"serial_number": "GP2A.2891092711.017",
"is_active": true,
"created_at": "07.06.2023 22:44:47"
}
]Respuestas de error
| Estado | Descripción |
|---|---|
401 | No autorizado: token inválido o ausente |