Squarespace - Obtener Productos

Descripción

Este módulo permite consultar los productos de una tienda Squarespace. Puede obtener un producto específico por ID o listar productos con filtros de tipo y fecha de modificación.

Configuración

Credenciales Requeridas

• API Key: Clave API de Squarespace (Configuración > Avanzado > API de desarrollador)

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Squarespace
product_id	string	No	ID del producto específico
type	select	No	Tipo: PHYSICAL, DIGITAL, SERVICE, GIFT_CARD
modifiedAfter	string	No	Productos modificados después de (ISO 8601)
modifiedBefore	string	No	Productos modificados antes de (ISO 8601)
cursor	string	No	Cursor de paginación

Salida

{
  "success": true,
  "products": [...],
  "count": 25,
  "hasNextPage": true,
  "nextCursor": "abc123...",
  "message": "25 productos obtenidos"
}

Campos de Producto

• id: ID del producto
• name: Nombre del producto
• description: Descripción
• url: URL del producto
• urlSlug: Slug de la URL
• type: Tipo de producto (PHYSICAL, DIGITAL, SERVICE, GIFT_CARD)
• isVisible: Visibilidad
• variants: Array de variantes
• images: Array de imágenes
• createdOn: Fecha de creación
• modifiedOn: Fecha de modificación

Ejemplo de Uso

Obtener producto por ID

{
  "product_id": "5f3e..."
}

Listar productos físicos

{
  "type": "PHYSICAL"
}

Productos modificados recientemente

{
  "modifiedAfter": "2024-01-01T00:00:00Z"
}

API Utilizada

• Endpoint: GET /1.0/commerce/products
• Documentación: Squarespace Commerce API

Notas

• La API de Squarespace usa paginación basada en cursor
• Los productos incluyen todas las variantes en un solo objeto
• El tipo GIFT_CARD es para tarjetas de regalo digitales
• Los productos no pueden ser creados o modificados via API (solo lectura)

Nodos Relacionados

• SquarespaceGetInventory - Obtener niveles de inventario de productos
• SquarespaceUpdateInventory - Ajustar inventario de variantes
• SquarespaceGetOrders - Obtener pedidos que incluyen productos