Inicio Rápido

Descripción General

La API de Whatalo te permite gestionar programáticamente productos, pedidos, clientes y más para cualquier tienda Whatalo. Esta guía te acompaña en tu primera llamada a la API.

Explora la Documentación

Whatalo API

Endpoints REST para productos, pedidos, clientes, webhooks y gestión de tienda.

Plugin SDK

Crea plugins que extienden el admin con iframes, App Bridge y facturación.

Theme SDK

Crea temas personalizados para storefronts con secciones, bloques y el editor visual.

Paso 1: Obtén tu API Key

Inicia sesión en el dashboard de tu tienda Whatalo
Ve a Settings > Developer > API Keys
Haz clic en Create API Key
Selecciona los scopes que necesitas (ej. read:products)
Copia la clave — comienza con wk_live_ o wk_test_

Tu API key se muestra una sola vez. Guárdala de forma segura — no podrás recuperarla después.

Paso 2: Haz tu Primera Petición

cURL

curl -X GET https://api.whatalo.com/v1/products \
  -H "X-API-Key: wk_test_your_key_here"

JavaScript (fetch)

const response = await fetch("https://api.whatalo.com/v1/products", {
  headers: {
    "X-API-Key": "wk_test_your_key_here",
  },
});

if (!response.ok) {
  throw new Error(`API error: ${response.status}`);
}

const { data } = await response.json();

Python

import requests

response = requests.get(
    "https://api.whatalo.com/v1/products",
    headers={"X-API-Key": "wk_test_your_key_here"},
)

print(response.json())

Paso 3: Explora la API

Ahora que tu clave funciona, explora la API completa:

Recurso	Endpoint	Descripción
Products	`GET /v1/products`	Listar todos los productos
Orders	`GET /v1/orders`	Listar todos los pedidos
Customers	`GET /v1/customers`	Listar todos los clientes
Store	`GET /v1/store`	Obtener info de la tienda
Categories	`GET /v1/categories`	Listar categorías
Discounts	`GET /v1/discounts`	Listar descuentos

Entornos

Entorno	Prefijo de Clave	Uso
Test	`wk_test_`	Desarrollo y pruebas
Live	`wk_live_`	Integraciones en producción

Las claves de test funcionan con los mismos datos pero tienen límites de tasa más agresivos. Úsalas durante el desarrollo.

Siguientes Pasos

Autenticación — Entiende scopes y límites de tasa
Webhooks — Recibe notificaciones cuando ocurren eventos
Referencia API — Documentación completa de endpoints