Tablero de Control API

Bienvenido al centro de desarrolladores de LogiHub. Desde aquí podrás acceder a toda la documentación necesaria para integrar nuestros servicios de logística.

Token de Acceso

Tu token actual: IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar

Nota: Todos los endpoints requieren este token en el header de autorización.

APIs de Envío

GET /api/shipments/get

Obtiene la lista de envíos asociados a tu cuenta.

Función principal

Este endpoint permite consultar todos los envíos registrados en tu cuenta, con información detallada sobre cada uno, incluyendo estado actual, fechas y detalles de envío.

Parámetros

Parámetro	Detalles	Descripción	Valor
token	Requerido	Token de autenticación	Enviar en el header

Ejemplo de solicitud

GET /api/shipments/get

GET /api/shipments/get HTTP/1.1
Host: logistica.logihub.tech
Authorization: Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar
Accept: application/json

Detalles de implementación

Esta solicitud GET requiere:

Cabecera Authorization: Con el token Bearer para autenticación
Cabecera Accept: Para especificar que esperas respuesta en JSON

No requiere parámetros en el cuerpo de la solicitud.

Ejemplo de respuesta

Respuesta JSON

{
    "success": true,
    "data": [
        {
            "id": 12345,
            "tracking_number": "LH123456789",
            "status": "en_ruta",
            "shipping_date": "13-04-2025",
            "client_phone": "+18095551234",
            "reciver_name": "Juan Pérez",
            "reciver_phone": "+18095554321",
            "payment_type": "prepaid",
            "created_at": "2025-04-12T14:30:00Z"
        }
    ]
}

Estructura de la respuesta

La respuesta incluye un array con todos los envíos asociados a tu cuenta:

success: Indica si la solicitud fue exitosa
data: Array de objetos con los envíos
Cada envío contiene información clave como número de tracking, fechas y estado actual

POST /api/shipments/create

Crea un nuevo envío en el sistema de LogiHub.

Función principal

Este endpoint permite registrar nuevos envíos en el sistema. Es el punto de entrada principal para integrar tus sistemas con nuestra plataforma logística.

Al crear un envío, el sistema generará automáticamente:

Número de tracking único
Etiquetas de envío
Información para el cliente

Parámetros

Parámetro	Detalles	Descripción	Valor
token	Requerido	Token de autenticación	Enviar en el header
Shipment[type]	Requerido	Tipo de envío	1 (Pickup) / 2 (Drop off)
Shipment[branch_id]	Requerido	ID de la sucursal	1-27
Shipment[shipping_date]	Requerido	Fecha de envío	DD/MM/YYYY (ej: 13-04-2025)
Shipment[client_phone]	Opcional	Teléfono del cliente	Valor predeterminado: tu teléfono
Shipment[client_address]	Requerido	Dirección del cliente	ID de dirección
Shipment[reciver_name]	Requerido	Nombre del destinatario	-
Shipment[reciver_phone]	Requerido	Teléfono del destinatario	-
Shipment[reciver_address]	Requerido	Dirección del destinatario	-
Shipment[from_country_id]	Requerido	ID del país de origen	ID (ej: 1)
Shipment[to_country_id]	Requerido	ID del país de destino	ID (ej: 1)
Shipment[from_state_id]	Requerido	ID del estado/provincia de origen	ID (ej: 1)
Shipment[to_state_id]	Requerido	ID del estado/provincia de destino	ID (ej: 1)
Shipment[from_area_id]	Requerido	ID del área de origen	ID (ej: 1)
Shipment[to_area_id]	Requerido	ID del área de destino	ID (ej: 1)
Shipment[payment_type]	Requerido	Tipo de pago	1 (Postpaid) / 2 (Prepaid)
Shipment[payment_method_id]	Requerido	ID del método de pago	ID (ej: 1)
Shipment[attachments_before_shipping]	Opcional	Adjuntos antes del envío	-
Package[package_index][package_id]	Requerido	ID del paquete	ID (ej: 1)
Package[package_index][description]	Opcional	Descripción del paquete	-
Package[package_index][qty]	Opcional	Cantidad	Valor predeterminado: 1
Package[package_index][weight]	Opcional	Peso	Valor predeterminado: 1
Package[package_index][length]	Opcional	Largo	Valor predeterminado: 1
Package[package_index][width]	Opcional	Ancho	Valor predeterminado: 1
Package[package_index][height]	Opcional	Alto	Valor predeterminado: 1
Shipment[amount_to_be_collected]	Opcional	Cantidad a cobrar	Valor predeterminado: 0
Shipment[order_id]	Opcional	ID de orden	-
Shipment[delivery_time]	Opcional	Tiempo de entrega	-
Shipment[collection_time]	Opcional	Tiempo de recolección	Formato: HH:MM:SS AM/PM (ej: 01:12:22 AM)

Ejemplo de solicitud

cURL Request

curl -X POST \
  https://logistica.logihub.tech/api/shipments/create \
  -H 'Authorization: Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'Shipment[type]=1' \
  -d 'Shipment[branch_id]=1' \
  -d 'Shipment[shipping_date]=13-04-2025' \
  -d 'Shipment[client_address]=7' \
  -d 'Shipment[reciver_name]=Juan Pérez' \
  -d 'Shipment[reciver_phone]=+18095554321' \
  -d 'Shipment[reciver_address]=Calle Principal 123' \
  -d 'Shipment[from_country_id]=1' \
  -d 'Shipment[to_country_id]=1' \
  -d 'Shipment[from_state_id]=1' \
  -d 'Shipment[to_state_id]=2' \
  -d 'Shipment[from_area_id]=1' \
  -d 'Shipment[to_area_id]=3' \
  -d 'Shipment[payment_type]=1' \
  -d 'Shipment[payment_method_id]=1' \
  -d 'Package[0][package_id]=1' \
  -d 'Package[0][description]=Paquete de ejemplo' \
  -d 'Shipment[collection_time]=01:12:22 AM'

Implementación con cURL

Este comando cURL muestra cómo:

Enviar una solicitud POST con autenticación Bearer
Especificar el tipo de contenido como x-www-form-urlencoded
Incluir todos los parámetros requeridos para crear un envío
Estructurar los datos de paquetes usando índices numéricos

PHP Example

<?php
$url = 'https://logistica.logihub.tech/api/shipments/create';
$data = [
    'Shipment[type]' => 1,
    'Shipment[branch_id]' => 1,
    'Shipment[shipping_date]' => '13-04-2025',
    'Shipment[client_address]' => 7,
    'Shipment[reciver_name]' => 'Juan Pérez',
    'Shipment[reciver_phone]' => '+18095554321',
    'Shipment[reciver_address]' => 'Calle Principal 123',
    'Shipment[from_country_id]' => 1,
    'Shipment[to_country_id]' => 1,
    'Shipment[from_state_id]' => 1,
    'Shipment[to_state_id]' => 2,
    'Shipment[from_area_id]' => 1,
    'Shipment[to_area_id]' => 3,
    'Shipment[payment_type]' => 1,
    'Shipment[payment_method_id]' => 1,
    'Package[0][package_id]' => 1,
    'Package[0][description]' => 'Paquete de ejemplo',
    'Shipment[collection_time]' => '01:12:22 AM'
];

$options = [
    'http' => [
        'header' => [
            "Authorization: Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar",
            "Content-Type: application/x-www-form-urlencoded"
        ],
        'method' => 'POST',
        'content' => http_build_query($data))
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

Implementación en PHP

Este ejemplo muestra cómo crear un envío usando PHP nativo:

Preparar todos los datos requeridos en un array asociativo
Configurar el contexto HTTP con los headers necesarios
Usar http_build_query para codificar los datos
Enviar la solicitud usando file_get_contents con contexto

Python Example

import requests

url = "https://logistica.logihub.tech/api/shipments/create"
headers = {
    "Authorization": "Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar",
    "Content-Type": "application/x-www-form-urlencoded"
}

data = {
    "Shipment[type]": 1,
    "Shipment[branch_id]": 1,
    "Shipment[shipping_date]": "13-04-2025",
    "Shipment[client_address]": 7,
    "Shipment[reciver_name]": "Juan Pérez",
    "Shipment[reciver_phone]": "+18095554321",
    "Shipment[reciver_address]": "Calle Principal 123",
    "Shipment[from_country_id]": 1,
    "Shipment[to_country_id]": 1,
    "Shipment[from_state_id]": 1,
    "Shipment[to_state_id]": 2,
    "Shipment[from_area_id]": 1,
    "Shipment[to_area_id]": 3,
    "Shipment[payment_type]": 1,
    "Shipment[payment_method_id]": 1,
    "Package[0][package_id]": 1,
    "Package[0][description]": "Paquete de ejemplo",
    "Shipment[collection_time]": "01:12:22 AM"
}

response = requests.post(url, headers=headers, data=data)
print(response.json())

Implementación en Python

Este ejemplo utiliza la popular librería requests para:

Configurar los headers con el token de autorización
Estructurar los datos del envío como diccionario
Enviar la solicitud POST con los datos codificados
Procesar la respuesta JSON

Requisito: Instalar requests con pip install requests

Ejemplo de respuesta

Success Response

{
    "success": true,
    "message": "Envío creado exitosamente",
    "data": {
        "tracking_number": "LH123456789",
        "shipment_id": 12345,
        "estimated_delivery": "15-04-2025",
        "shipping_cost": 15.50
    }
}

Análisis de la respuesta

Una respuesta exitosa contiene:

success: true indica que el envío se creó correctamente
message: Mensaje descriptivo del resultado
data: Información clave del envío creado:
- tracking_number: Número único para rastrear el envío
- shipment_id: ID interno del envío en el sistema
- estimated_delivery: Fecha estimada de entrega
- shipping_cost: Costo calculado del envío

Autenticación API

Todas las solicitudes a la API de LogiHub requieren autenticación mediante un token de acceso.

¿Cómo funciona la autenticación?

El sistema utiliza tokens Bearer para autenticar cada solicitud. Estos tokens:

Son únicos para cada cuenta
Deben incluirse en el header Authorization
Tienen una validez indefinida pero pueden regenerarse
Proveen acceso a todos los endpoints asociados a tu cuenta

Ejemplo de uso del token

Encabezado HTTP

Authorization: Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar

Implementación requerida

Debes incluir este header en todas las solicitudes a la API. Ejemplos:

Ejemplo en Fetch API

fetch('https://logistica.logihub.tech/api/shipments/get', {
    headers: {
        'Authorization': 'Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar',
        'Accept': 'application/json'
    }
})

Ejemplo en Axios

axios.get('https://logistica.logihub.tech/api/shipments/get', {
    headers: {
        'Authorization': 'Bearer IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar'
    }
})

Gestión de Tokens

Token actual: IYBec0bPKK7GrPPxC4mKFWbJQP0Mmv3f8g01kYSUyaQ7uqU3uiHEBNeFSXWECopiar

Nota: Al regenerar el token, el token anterior dejará de funcionar inmediatamente.

Soporte Técnico

Para asistencia con la integración de la API, contáctanos a través de los siguientes canales:

Teléfono

+1 809-991-9972

Horario: Lunes a Viernes, 8:00 AM - 5:00 PM

Email

info@logihub.tech

Respuesta en menos de 24 horas

Ticket de soporte

Abrir un ticket

Seguimiento de incidencias

Documentación API

Recursos

Tablero de Control API

Token de Acceso

APIs de Envío

Función principal

Parámetros

Ejemplo de solicitud

Detalles de implementación

Ejemplo de respuesta

Estructura de la respuesta

Función principal

Parámetros

Ejemplo de solicitud

Implementación con cURL

Implementación en PHP

Implementación en Python

Ejemplo de respuesta

Análisis de la respuesta

Autenticación API

¿Cómo funciona la autenticación?

Ejemplo de uso del token

Implementación requerida

Gestión de Tokens

Soporte Técnico

Teléfono

Email

Ticket de soporte

Recursos adicionales