Documentacion

Guia de integracion

Conecta tu plataforma con StockOnline en minutos. Autenticacion, formato de respuestas y buenas practicas.

Autenticacion

Todas las llamadas a la API necesitan un token Bearer. Genera el tuyo desde el panel de API.

bash
curl https://api.stockonline.ai/api/v1/products \
  -H "Authorization: Bearer sk_live_tu_token" \
  -H "Content-Type: application/json"

Todas las respuestas incluyen un objeto data y metadatos de paginacion en meta.

json
{
  "data": [{ "id": 1, "title": "Zapatilla Runner", ... }],
  "meta": { "page": 1, "limit": 50, "total": 234 }
}

Cada token permite 60 requests por minuto. Revisa los headers para monitorear tu uso:

`X-RateLimit-Limit`	Maximo de requests por ventana
`X-RateLimit-Remaining`	Requests disponibles
`HTTP 429`	Limite excedido, espera 1 minuto

Cada token tiene permisos especificos. Solicita solo lo que necesitas.

products:readLectura

products:writeEscritura

orders:readLectura

orders:writeEscritura

customers:readLectura

customers:writeEscritura

inventory:readLectura

inventory:writeEscritura

shipping:readLectura

shipping:writeEscritura

Los errores usan codigos HTTP estandar y un mensaje descriptivo.