Saltar al contenido principal

Primeros pasos

OmniBuy expone una API REST completa bajo /api/v1. Esta guía te lleva desde cero hasta tu primera llamada exitosa.

1. Crea tu cuenta​

  1. Regístrate en app.omnibuy.net/admin/register
  2. Verifica tu email
  3. Completa el wizard de onboarding (≤ 3 min)

2. Obtén tus credenciales​

Desde Admin → Configuración → API, genera un API Token.

export OMNIBUY_TOKEN="tok_live_xxxxxxxxxxxx"
export OMNIBUY_TENANT="mi-tienda"   # tu subdominio

3. Primera llamada​

curl https://app.omnibuy.net/api/v1/catalog/products \
  -H "Authorization: Bearer $OMNIBUY_TOKEN" \
  -H "X-Tenant-ID: $OMNIBUY_TENANT"

Respuesta esperada:

{
  "data": [],
  "meta": {
    "pagination": {
      "cursor": null,
      "has_next": false,
      "limit": 25
    }
  }
}

4. Crea tu primer producto​

curl -X POST https://app.omnibuy.net/api/v1/catalog/products \
  -H "Authorization: Bearer $OMNIBUY_TOKEN" \
  -H "X-Tenant-ID: $OMNIBUY_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Polo OmniBuy",
    "slug": "polo-omnibuy",
    "price": 5500,
    "currency": "PEN",
    "status": "active"
  }'
Precios en centavos

Todos los campos de precio usan centavos enteros (int64). 5500 = S/ 55.00

Siguientes pasos​