La API de Lengow permite el intercambio de datos entre Lengow y tu back office (puede ser tu propio back office, o un software como Prestashop, Magento, etc...).
Diferentes "endpoints" pueblan la API:
- /orders/
Recupera todos tus pedidos de cualquier marketplace que hayas configurado en Lengow
- /orders/actions/
- /marketplaces/
No es posible realizar ninguna acción aquí.
Ejecutando solicitudes / Códigos de respuesta HTTP
La API de Lengow proporciona códigos de respuesta HTTP para cada solicitud que corresponden con el cuerpo y la acción que el usuario ha intentado.
Aquí están los códigos de respuesta más comunes utilizados por la API de Lengow:
- Código 200: OK = El código de éxito de la respuesta de estado OK HTTP 200 indica que la solicitud ha tenido éxito.
- Código 201: Creado = La solicitud ha sido cumplida, se ha creado un nuevo recurso.
- Código 202: Aceptado = La solicitud ha sido aceptada para su procesamiento, pero el procesamiento no ha sido completado.
- Código 400: Solicitud incorrecta = El servidor no puede o no procesará la solicitud debido a un error aparente del cliente (validación, URL de recurso incorrecta, etc).
- Código 401: Acceso no concedido = Se utiliza cuando se requiere autenticación y ha fallado o aún no se ha proporcionado.
- Código 403: Prohibido = La solicitud era válida, pero el servidor se niega a actuar. No se permite el uso del recurso.
- Código 404: No encontrado = El recurso solicitado no pudo ser encontrado pero puede estar disponible en el futuro.
- Código 429: Límite de solicitudes alcanzado = Se han hecho demasiadas solicitudes en un periodo de tiempo demasiado corto.
- Código 530: Error lógico = La solicitud ha fallado probablemente debido a parámetros de entrada incorrectos (catálogo que no existe, reglas de búsqueda inválidas...). Ver el mensaje acompañante para más información.
- Código 540: Error técnico = La solicitud ha fallado debido a un error interno. Ver el mensaje acompañante para más información.
Encabezados Content-Type y Accept
El encabezado "Accept" especifica el formato de la solicitud que quieres recibir.
En contraste, el encabezado "Content-Type" define el formato que el llamante está enviando a la API. Dependiendo del endpoint, la API de Lengow soporta un conjunto de diferentes formatos de mensaje.
Si quieres cambiar el formato de los datos devueltos, puedes establecer el encabezado Accept . El servidor te responderá con el formato dado y cambiará el encabezado Content-Type.
- Por defecto, el formato es “application/json”.
Para obtener todos los formatos aceptados, puedes usar el método OPTIONS como se muestra a continuación:
/orders/
ir a OPTIONS > headers
Key: Accept: application/json"
Cambia la clave con el formato solicitado.
fuente de la imagen: Postman
Campos de fecha y hora
Los campos de fecha y hora se presentan en el estándar ISO-8601 truncado a segundos con un desplazamiento desde UTC.
El formato de fecha y hora utilizado para la API de Lengow se enumera a continuación (nuestro ejemplo está en JSON, y puede variar en otros lenguajes de programación. Por favor, consulta la documentación de tu lenguaje para más información).
Formato: yyyy-MM-dd'T'HH:mm:ssXXX
Ejemplo de salida de fecha/hora:
{
"marketplace_order_date": "2019-03-22T17:54:34.369000Z"
}
Precios, Monedas y Países
- Todas las cantidades monetarias como los precios se especifican como número decimal.
Ejemplo: 5.50
- Todas las monedas se especifican con tres caracteres, según la convención ISO 4217.
Ejemplo : EUR
- Dependiendo del recurso, los países se especifican con dos o tres caracteres, según la convención ISO 3166-2.
Ejemplo: FR
Ejecutando solicitudes / Métodos HTTP
Métodos HTTP soportados:
- GET
- POST
- PUT: reemplazar datos existentes
- PATCH: actualizar algunos campos de datos existentes
- DELETE: eliminar datos existentes
fuente de la imagen: Postman
Redirección automática HTTPS
Cierre de servicios HTTP en favor de HTTPS
Como parte de la mejora continua de la seguridad dentro de nuestra plataforma y para garantizar la seguridad de sus datos, la redirección automática de flujos HTTP al protocolo HTTPS ya no estará disponible a partir del 1 de septiembre de 2022.
Sin acción por su parte, se producirán interrupciones del servicio sin que nuestros equipos de soporte puedan actuar en la resolución del problema.
¿Cómo mantener la disponibilidad de nuestros servicios?
Para garantizar la disponibilidad de nuestros servicios desde sus herramientas, recomendamos que revise y actualice sus configuraciones.
Dependiendo de su organización y alcance de acción, puede ser necesario que su departamento técnico aplique los cambios.
¿Dónde verifico esta información?
Depende de cómo utilice la plataforma Lengow.
- Si tiene herramientas para monitorear sus pedidos, importar catálogos o cualquier otra información a un ERP:
Verifique la configuración de estas herramientas. Si la configuración de su herramienta indica una URL http://api.lengow.io/..., solo necesita reemplazar el "http" por "https" (https://api.lengow.io/...) y guardar la modificación.
- Si ha configurado URLs cortas de Lengow en uno o más canales:
Para continuar exportando sus catálogos a los canales, verifique la configuración guardada en cada uno de ellos. Si la configuración indicada utiliza el protocolo HTTP (http://feeds.lengow.io/3/...), cambie la URL para usar el protocolo HTTPS (https://feeds.lengow.io/3/...)
Después de validar sus cambios, puede verificar que el servicio actualizado está funcionando correctamente.
