Guía rápida

En esta guía vas a autenticarte contra la API y hacer tu primer request a /products.

Asumimos que ya tenés credenciales de un seller activo. Si todavía no las tenés, contactate con Soporte.

Prerrequisitos

• Usuario y password de un seller activo en Fulljaus.
• Una herramienta para hacer requests HTTP, como curl, Postman o Insomnia.

Paso 1 - Autenticarse

Pedí un access token con POST /auth/login.

curl -X POST "https://api.fulljaus.com/api/v2/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"seller@fulljaus.com","password":"mi_password"}'

Respuesta exitosa:

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "refresh_token": "a1b2c3d4...",
  "user_id": 821,
  "seller_id": 347,
  "expires_in": 900
}

El campo token es el access token JWT. Mandalo en Authorization: Bearer ... en cada request siguiente.

El access token dura 15 minutos (expires_in: 900). Cuando expire, renovalo con el refresh token. El flujo completo está en Autenticación.

Paso 2 - Hacer tu primer request

Usá el token para consultar productos del seller autenticado.

curl -X GET "https://api.fulljaus.com/api/v2/products?page=1&maxResults=20" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

page y maxResults son los parámetros estándar de paginación de la API.

El response te devuelve un listado de productos del seller autenticado.

Errores comunes

Síntoma	Código	Acción
Credenciales rechazadas	401	Verificá username y password. Ver Autenticación.
Token expirado	401	Renová con el refresh token.
Demasiados intentos	429	Leé Retry-After. Ver Rate limits.

Próximos pasos

• Autenticación - flujo completo de tokens y renovación.
• Seller - entendé el contexto en el que opera tu API.
• Catálogo - modelo de productos, marcas, categorías y publicaciones.
• API Reference - referencia completa de endpoints.