Passer au contenu principal
PUT
cURL

Autorisations

Authorization
string
header
requis

Pour vos propres scripts et vos intégrations de serveur à serveur. Créez une clé dans l'application sous Paramètres > Accès > Clés d'API et copiez-la à ce moment-là, car elle n'est affichée qu'une fois. Envoyez-la sous la forme Authorization: Bearer <key>. La clé agit en tant que le membre qui l'a créée, dans l'organisation où elle a été créée. Un appel exige l'autorisation du membre et l'une des portées de la clé, comme inventory:read ou sales:write. Une clé avec * a toutes les portées.

Paramètres de chemin

family
string
requis

L'ID de la famille de variantes, un UUID.

Corps

application/json

Les nouveaux champs communs et les nouvelles options d'une famille de variantes. Une fois que des variantes existent, une option conserve son nom et une valeur utilisée est conservée.

name
string
requis

Le nom de la famille, 255 caractères au plus.

Maximum string length: 255
options
object[]
requis

Les options qui distinguent les variantes, comme Taille et Couleur : d'une à trois, dans l'ordre. Chacune a un name d'au plus 50 lettres, chiffres et espaces, unique sans égard à la casse, et une liste de 1 à 50 values, chacune d'au plus 50 caractères et unique dans l'option, sans égard à la casse.

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

Une description que toutes les variantes partagent à moins d'avoir la leur, d'au plus 5,000 caractères.

Maximum string length: 5000
custom_fields
object

Valeurs de champs personnalisés que les variantes de la famille partagent : texte, nombre (une chaîne décimale est exacte), date YYYY-MM-DD, booléen ou l'une des options d'un champ de sélection.

Réponse

ItemFamilyPageResource

data
ItemFamilyPageResource · object
requis

Une famille et ses variantes, par UGS.