Saltar al contenido principal
PUT
Reorder products

📌 Endpoint

PUT /stores/{storeId}/products/reorder Reordena los productos de la tienda según la secuencia enviada en productIds.

🔐 Autenticación

  • Ruta privada.
  • Envíe Authorization con su API Key.

🧾 Parámetros de ruta


🧍 Body


✅ Ejemplo de petición


📦 Respuesta exitosa (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → payload inválido, array vacío, IDs duplicados o elementos que no son UUIDs válidos
  • 400 PRODUCT_LIST_INVALID → uno o más IDs no pertenecen a la tienda
  • 401 API_KEY_NOT_PROVIDED → header Authorization no enviado (o TOKEN_NOT_PROVIDED vía Bearer)
  • 401 INVALID_API_KEY → API Key inválida (o INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED vía Bearer)
  • 403 USER_DISABLED → usuario desactivado o eliminado
  • 403 NO_ACTIVE_SUBSCRIPTION → plan inactivo o expirado (o PENDING_2FA vía Bearer)
  • 404 STORE_NOT_FOUND → tienda no encontrada o sin permiso
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio o base de datos no disponible

📝 Observaciones

  • El endpoint GET /stores/{storeId}/products devuelve los productos ordenados por position.
  • El frontend debe enviar la lista completa de IDs en el orden final para garantizar consistencia.

Autorizaciones

Authorization
string
header
predeterminado:YOUR_API_KEY_HERE
requerido

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50

Cuerpo

application/json

Ordered product IDs.

productIds
string<uuid>[]
requerido
Minimum array length: 1

Respuesta

Positions updated in provided order.

code
string
requerido
Ejemplo:

"PRODUCTS_REORDERED"