WoowUp Developer Docs
Woowup
  • Getting Started (EN)
  • Primeros Pasos (ES)
  • API
    • Users
    • Purchases
    • Products
    • Benefits
    • Coupons
    • Events
      • Garantía Extendida
    • Custom Attributes
    • Branches
    • Blacklist
    • Abandoned carts
    • Reset account
    • Integration Stats
    • Categories
    • Segment Export
  • Web Tracking
    • Configuración Navegación Web
  • Push Notifications
    • Configuración Notificaciones Web Push en Magento / Web Custom
    • Configuración Push en VTEX Legacy
    • Configuración Push en VTEX IO
    • ¿Cómo saber si la configuración fue exitosa?
  • Formularios Web
    • Formulario HTML / Script JS Newsletter
  • VTEX
    • Conectar Cuenta
    • Trigger Carrito Abandonado
    • Trigger Newsletter
    • VTEX APP Instalación
    • VTEX APP Configuración
  • Magento 1
    • Conectar Cuenta
    • Extension Carrito Abandonado
  • Magento 2
    • Conectar Cuenta
  • Shopify
    • Conectar Cuenta
  • Woocommerce
    • Conectar Cuenta
    • Extensión Carrito Abandonado
  • Prestashop
    • Conectar Cuenta
  • E3
    • Conecta tu eCommerce E3
  • Tienda Nube
    • Conectar Cuenta
  • Mensajería
    • SendGrid: Conectar Cuenta
    • Perfit: Conectar Cuenta
    • Infobip: Conectar Cuenta
  • Editor de campañas
    • Motor de template de emails
  • Data Processing
    • WoowUp Connectors
    • Migración a Multi - ID
  • How To
    • SurveyKiwi: Conectar Cuenta
      • Untitled
    • Snappy: Conectar Cuenta
    • Zendesk: Conectar Cuenta
  • Integración CSV / SQL
    • Primeros pasos
    • Archivo de Tiendas
    • Archivo de Categorías
    • Archivo de Productos
    • Archivo de Clientes
    • Archivo de Ventas
    • Archivo de Medios de Pago
    • Archivo de Miembros de Familia
  • Validación de Datos
  • ¿Cómo completar el Blueprint?
Powered by GitBook
On this page
  • Getting Started
  • Elementos esenciales a tener en cuenta
  • Autenticación
  • Paginación
  • Returned Format
  • Codificar 'service_uid'
  • Código de muestra

Was this helpful?

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.

PreviousGetting Started (EN)NextUsers

Last updated 5 years ago

Was this helpful?

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. 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 .

  • 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 .

  • 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

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

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:

Aquí
aquí
productos
Ejemplo de descarga