¡Todo lo que necesitas saber sobre nuestra querida API de Lengow!
En esta página te ayudaremos a comenzar con nuestros casos de uso de la API y los conceptos clave explicados.
Por favor, ten en cuenta que ofrecemos una solución de plugin para my.lengow.io que puedes usar en lugar de nuestra API si tienes un back office en Prestashop, Magento, Shopify, Shopware o Woocommerce.
Antes de empezar a conectarte a nuestra API necesitas registrarte registrarte para una cuenta de Lengow. Esto te permitirá autenticarte y conectarte a la API.
Nuestra documentación técnica de la API está aquí.
La API de Lengow utiliza el estándar REST.
A lo largo de esta guía te recomendamos que uses Postman para ayudarte a integrar y probar nuestra API.
Lengow no proporciona soporte en Postman.
Conceptos clave
Antes de empezar, deberías entender algunos conceptos centrales en la API:
- API
Una interfaz de programación de aplicaciones (API) es una interfaz de computación que define las interacciones entre múltiples intermediarios de software.
Funciona en un principio de entrada y salida, es decir, se utiliza para enviar acciones y recuperar información entre dos sistemas.
La propia API define los tipos de llamadas a la acción y solicitudes que se pueden hacer, cómo hacerlas, y el formato esperado que debe usarse para que funcione.
Más información aquí.
- Token de acceso
Para autenticarte necesitas obtener un token de acceso. Es un bloque de caracteres que contiene las credenciales de seguridad para una sesión de inicio de sesión e identifica al usuario (tú).
Ejemplo de token: "6b7280eb-e7d4-4b94-a829-7b3853a20126"
- Encabezado de autorización
>El encabezado de autorización contiene tus credenciales de autenticación. Una vez que tienes tu token, todas tus solicitudes de API necesitarán un encabezado de autorización.
- Punto final
La ubicación donde la API envía una solicitud y de donde emana la respuesta se conoce como un punto final.
- Paginación
Un ejemplo común para los parámetros de consulta es la paginación. Los recursos que devuelven listas de entidades están todos paginados. Para usar la paginación, el usuario especifica un parámetro de consulta de página con un número de página dado, un número entero no negativo. Cuando se omite, el valor predeterminado para la página es 1.
Ejemplo: /orders/?account_id=1&page=5&page_size=50
Parámetros de consulta (Filtrado)
Con el uso de parámetros de consulta, los usuarios pueden definir filtros adicionales que pueden limitar el número de entidades devueltas en la respuesta. Los usuarios pueden especificar opcionalmente los parámetros de consulta y combinarlos a voluntad. Los parámetros de consulta se añaden al final de una ruta de recurso.
El primer parámetro de consulta se indica con "?", todos los parámetros de consulta adicionales se separan con el símbolo "&".
Ejemplo: /orders/?account_id=1&marketplace=menlook
- Productos
Un producto es cualquier artículo que puede ser enviado desde Lengow a un canal. Generalmente se define por su código de numeración de artículos europeos (EAN), o por un ID único que elegiste y enriquecido con descripciones, imágenes y otros contenidos.
- Pedidos y artículos de pedido
Cuando un cliente compra uno o más artículos en un canal se crea un pedido. El pedido contiene uno o más artículos de pedido. Cada artículo de pedido contiene un ID único, cantidad, precio, referencia del cliente, etc...
- Otros conceptos y flujos
Se crea un envío cuando uno o más artículos de pedido son enviados al cliente, se crea una devolución cuando un cliente quiere devolver un artículo de pedido y una cancelación se utiliza para cancelar un pedido o artículo de pedido.
El proceso completo de pedidos con Lengow se describe aquí.
Je suis désolé, mais vous n'avez pas fourni de texte à traduire ou d'URL à modifier.
