Inicio rápido

Haz tu primera llamada a Admin API en tres pasos: crea una app, pide un token y lista tus productos.

Crea una app

En el panel de Ecomiq, abre tu tienda y entra a Configuración → Desarrolladores → Crear app.

• En Conexión, deja Desde tu servidor.
• En Acceso, elige una plantilla o solo las áreas que tu integración necesita.

La app solo entra a esa tienda. Al guardar ves el client_id y el client_secret. El secreto se muestra una sola vez: guárdalo en tu servidor. Si lo pierdes, rótalo desde la misma pantalla.

Pide un token

Cambia las credenciales por un token en Auth:

curl -X POST https://auth.ecomiq.pe/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$ECOMIQ_CLIENT_ID" \
  -d "client_secret=$ECOMIQ_CLIENT_SECRET" \
  -d "scope=api_admin"

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6...",
  "token_type": "Bearer",
  "expires_in": 3600
}

El token dura expires_in segundos. Cuando venza, pide otro.

Lista tus productos

Envía el token en Authorization:

curl "https://api.ecomiq.pe/api/v1/catalog/products?limit=25" \
  -H "Authorization: Bearer $ECOMIQ_TOKEN"

El token ya sabe en qué tienda opera. Para trabajar en otra tienda, crea otra app en ella.

Prueba sin riesgo

Cada llamada cambia datos reales. Para probar:

• Crea una tienda de pruebas con su propia app. Cuenta para el límite de tiendas de tu plan.
• Usa métodos de pago manuales para no cobrar de verdad.

Admin, Storefront y Auth aceptan el token de una app. Una API key creada con POST /v1/api-keys no sirve para ninguna de las tres.

Siguientes pasos

• Autenticación: renovar el token y errores de OAuth.
• Integración con ERP: productos, stock y pedidos desde tu sistema.
• Admin API: todas las operaciones.