API v1 y tokens de acceso

Qué permite la API

La API v1 le entrega tu catálogo y tu stock a otro sistema, como tu tienda en línea.

• GET /api/v1/products: los productos con su categoría y sus variantes (SKU, código de barras, descripción).
• GET /api/v1/stocks: el stock por variante y bodega, con cantidad, reservado y disponible.
• Las dos aceptan el parámetro «updated_after» (fecha y hora) para traer solo lo que cambió desde la última consulta.

El token de acceso

Cada token pertenece a una sola empresa y solo ve los datos de esa empresa. Empieza con «gof_live_» y se muestra una sola vez, al crearlo: GoFlare no lo guarda legible, así que si lo pierdes hay que crear otro.

• Lo pide un administrador de la empresa desde Administración → Soporte y sugerencias, indicando para qué sistema es; lo mismo para revocarlo.
• Guárdalo como una clave: quien lo tenga puede leer tu catálogo y tu stock.

Usar el token

1. 1En el sistema que se conecta, configura una consulta GET a la dirección de la API.
2. 2Agrega el encabezado «Authorization: Bearer gof_live_…» con tu token completo.
3. 3Para sincronizar, guarda la hora de cada consulta y envíala en «updated_after» la próxima vez.

Errores y revocación

• Sin token, o con uno que no empieza con «gof_live_», la API responde 401 con «token requerido».
• Con un token revocado o mal copiado, responde 401 con «token inválido o revocado». Nunca devuelve una lista vacía en ese caso, para que tu tienda no deje el stock en cero por error.
• Si un token se filtró, pide revocarlo y uno nuevo para el sistema que lo usaba.