Primeros Pasos (ES)

Aquí encontrará ejemplos y una lista detallada de puntos finales que le permitirá integrar WoowUp con los sistemas que utiliza via API.

Getting Started

Esta es una API de estilo REST que utiliza JSON para la serialización.

Para comenzar a utilizar la API necesitará:

  • Inicie sesión en WoowUp y obtenga su clave API en la sección Configuración / Mi cuenta.

Recuerda que debes tener permisos de Super Admin para ver las claves.

  • Lea los documentos de la API para comprender lo que puede hacer.

Elementos esenciales a tener en cuenta

  • La API está limitada a 10 peticiones / segundo. Si superas este límite, recibirás una excepción.

  • Toda solicitud recibe y devuelve datos en formato JSON.

  • Recuerde incluir en el header Basic Authentication al llamar a cualquier endpoint. Aquí encontrarás cómo hacerlo.

  • Para identificar a un cliente use el campo "service_uid". Normalmente, usará el correo electrónico o la ID (DNI, CPF, RUT, Pasaporte) para identificar al cliente.

  • Cada vez que vaya a usar service_uid como parte de la URL, primero deberá codificarlo con base64 y luego con URL encode. Puedes leer aquí una explicación detallada aquí.

  • Los formatos de fecha válidos son: AAAA-mm-dd HH: mm: ss (predeterminado en UTC) o formato ISO 8601 que incluye la zona horaria Ej .: 2004-02-12T15: 19: 21 + 03: 00

  • Normalmente, incluirá toda la Información del producto (sku, título, categoría, stock, etc.) en el punto final de Crear pedido de compra. Pero si lo prefiere, hay un endpoint específico para sincronizar productos.

  • Antes de enviar una orden de compra, debe crear el cliente si no existe. En el ejemplo, puede ver cómo funciona este proceso en el archivo "import_from_csv.php".

  • Por favor, preste atención a los mensajes de las respuestas de nuestra API porque le informaremos si algo está mal con sus solicitudes o con la información que envía.

Autenticación

En cualquier llamada a la API, debe enviar el API Key en la cadena de consulta como un parámetro.

Por ejemplo, si su API Key es 'abcdefghijklmnopqrstuvwxyz', debe hacer una solicitud para

https://api.woowup.com/apiv3/users?apikey=abcdefghijklmnopqrstuvwxyz

Otro método, y el recomendado, es a través del encabezado de autenticación, en cada llamada debe enviar el encabezado

Authorization: Basic abcdefghijklmnopqrstuvwxyz

Paginación

Cuando estás haciendo una búsqueda, paginamos los resultados. En todos los puntos finales paginados, los parámetros de la paginación son:

Parameter

Description

Default

limit

Items per page returned. Max: 100

25

page

Number of the page. First page is 0

0

Returned Format

Todos los endpoints devuelven datos en formato JSON, con el encabezado:

Content-Type: application / json

Para un uso correcto tienes que enviar en todas las solicitudes el encabezado

Accept: application / json.

Codificar 'service_uid'

Cuando intenta encontrar un usuario, puede identificarlo por su id o su service_uid (comúnmente es el correo electrónico), cuando usa service_uid debe codificar esto en Base64 y codificar el resultado como URL seguro, por ejemplo, si necesita hacer esto en php:

<?php
$service_uid = 'example@email.com';
$encoded_uid = urlencode(base64_encode($service_uid));
$url = 'https://api.woowup.com/apiv3/users/'.$encoded_uid.'/exist';

Código de muestra

Cómo empezar a enviarnos sus pedidos de compra En el siguiente enlace encontrará un ejemplo completamente funcional en PHP que procesa un archivo CSV con pedidos y clientes y utiliza la API para enviarlos a WoowUp: Ejemplo de descarga

No dude en ponerse en contacto con nosotros escribiendo a developers@woowup.com para cualquier consulta, estaremos encantados de atenderle.