Saltar al contenido principal

Referencia API

Bienvenido a la documentación de referencia de la API de Chronos. Aquí encontrarás información detallada sobre todos los endpoints disponibles, formatos de solicitud/respuesta y ejemplos de código.

URLs Base​

Nuestra API está disponible en dos entornos:

EntornoURL Base
Sandboxhttps://apisandbox.eonwms.com
Producciónhttps://api.eonwms.com
tip

Siempre comienza tu integración usando el entorno Sandbox. Contacta a nuestro equipo de soporte cuando estés listo para pasar a producción.

Autenticación​

Todas las solicitudes a la API requieren autenticación usando un token Bearer. Puedes obtener tu token usando el endpoint Obtener Token de Autenticación.

Authorization: Bearer TU_TOKEN_AQUI

Secciones de la API​

Nuestra API está organizada en las siguientes secciones:

🔐 Autorización​

Gestiona la autenticación y obtén tokens de acceso.

📦 Pedidos​

Crea, rastrea y gestiona pedidos de fulfillment.

  • Crear pedidos
  • Rastrear estado de pedidos
  • Obtener información de pedidos
  • Eliminar pedidos
  • Calcular tarifas de envío
  • Descargar etiquetas

🏭 Almacenes​

Consulta almacenes disponibles y sus capacidades.

📊 Productos​

Monitorea niveles de inventario de productos en los almacenes.

Formato de Solicitud​

Todas las solicitudes deben incluir los siguientes encabezados:

Content-Type: application/json
Accept: application/json
Authorization: Bearer TU_TOKEN_AQUI

Formato de Respuesta​

Todas las respuestas se devuelven en formato JSON con la siguiente estructura para solicitudes exitosas:

{
  "status": "success",
  "data": {
    // Datos de respuesta aquí
  }
}

Las respuestas de error siguen este formato:

{
  "fault": {
    "error": "codigo_error",
    "error_description": "Mensaje de error legible"
  }
}

Códigos de Estado HTTP​

Código de EstadoDescripción
200Éxito - Solicitud completada exitosamente
401No autorizado - Token de autenticación inválido o faltante
404No encontrado - Recurso no encontrado
422Entidad no procesable - Error de validación
500Error interno del servidor - Algo salió mal de nuestro lado

Límites de Velocidad​

Las solicitudes a la API están sujetas a límites de velocidad:

  • Sandbox: 60 solicitudes por minuto
  • Producción: Varía según el plan (consulta tu contrato)

La información sobre límites de velocidad se incluye en los encabezados de respuesta:

  • X-RateLimit-Limit: Máximo de solicitudes por minuto
  • X-RateLimit-Remaining: Solicitudes restantes
  • X-RateLimit-Reset: Hora en que se reinicia el límite

¿Necesitas Ayuda?​