Obtener todos los números de teléfono
Este endpoint permite recuperar una lista de todos los números de teléfono registrados en el sistema.
Método HTTP
GET
Endpoint URL
https://www.x-ianet.com/api/v1/xia_phone_numbers
Nota: Asumiendo que la ruta base de tu API es /api/v1/
y el recurso se llama xia_phone_numbers
. Ajusta esta URL según la configuración real de tus rutas.
Respuesta Exitosa (Código 200)
Si la solicitud es exitosa, el servidor responderá con un objeto JSON que contiene una lista de los números de teléfono.
{
"status": "Ok",
"data": [
{
"id": 1,
"phone_number": "+1234567890",
"type": "mobile",
"client_id": 101,
"created_at": "2023-01-15T10:00:00.000000Z",
"updated_at": "2023-01-15T10:00:00.000000Z"
// ... otros campos relevantes del número de teléfono
},
{
"id": 2,
"phone_number": "+0987654321",
"type": "work",
"client_id": 102,
"created_at": "2023-01-16T11:30:00.000000Z",
"updated_at": "2023-01-16T11:30:00.000000Z"
// ... otros campos relevantes del número de teléfono
}
// ... más registros si existen
],
"status_code": 200
}
Campos en cada objeto de `data`:
id
: Identificador único del número de teléfono.phone_number
: El número de teléfono.type
: Tipo de número (ej. "mobile", "work", "home").client_id
: (Opcional) ID del cliente al que pertenece el número, si aplica.created_at
: Fecha y hora de creación del registro.updated_at
: Fecha y hora de la última actualización del registro.- (otros campos): Cualquier otro campo relevante que tu modelo de `PhoneNumber` pueda tener.
Consideraciones Adicionales
- Este endpoint podría soportar paginación si la cantidad de números es muy grande.
- Podrían añadirse parámetros de filtrado y ordenación en el futuro (ej.
?type=mobile
,?sort_by=created_at
).