Saltar al contenido principal
PUT
cURL

Autorizaciones

Authorization
string
header
requerido

Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.

Parámetros de ruta

family
string
requerido

El ID de la familia de variantes, un UUID.

Cuerpo

application/json

Los campos compartidos y las opciones nuevos de una familia de variantes. Una vez que existen variantes, una opción conserva su nombre y un valor en uso permanece.

name
string
requerido

El nombre de la familia, de hasta 255 caracteres.

Maximum string length: 255
options
object[]
requerido

Las opciones en las que difieren las variantes, como Size y Color: de una a tres, en orden. Cada una tiene un name de hasta 50 letras, dígitos y espacios, único sin distinguir mayúsculas, y una lista de 1 a 50 values, cada uno de hasta 50 caracteres y único dentro de la opción, sin distinguir mayúsculas.

Required array length: 1 - 3 elements
description
string | null

Una descripción que comparten todas las variantes salvo que tengan la suya, de máximo 5,000 caracteres.

Maximum string length: 5000
custom_fields
object

Valores de campos personalizados que comparten las variantes de la familia: texto, un número (una cadena decimal es exacta), una fecha YYYY-MM-DD, un booleano o una de las opciones de un campo de selección.

Respuesta

ItemFamilyPageResource

data
ItemFamilyPageResource · object
requerido

Una familia y sus variantes, por SKU.