{"openapi":"3.1.1","info":{"title":"API client CodePersist","description":"L’API client est offerte avec les forfaits Lite et Premium. L’enregistrement crée une version immuable. Publiez-la séparément pour la mettre en ligne.\n\nEnvoyez un seul en-tête HTTP de requête `Authorization` sous la forme `Authorization: Bearer YOUR_API_KEY`. Remplacez `YOUR_API_KEY` par votre clé API. Utilisez une clé en lecture et écriture pour les opérations qui exigent un accès en écriture.\n\nEnvoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.\n\nRespectez exactement la casse camelCase des propriétés et des paramètres de requête documentés. Les propriétés JSON inconnues ou répétées et les paramètres de requête inconnus, répétés ou vides entraînent une réponse 400. Transmettez les nombres JSON sans guillemets et les booléens sous la forme true ou false. Les champs obligatoires doivent être présents, même s’ils acceptent null. Les champs non nullables et les éléments de tableau ne peuvent pas valoir null. Les UUID d’entrée contiennent 36 caractères avec traits d’union, acceptent les deux casses hexadécimales et ne peuvent pas être entièrement nuls. La taille maximale d’un corps JSON est de 256 Kio. Un corps trop volumineux entraîne une réponse 413 et un type de contenu non pris en charge, une réponse 415. Les opérations sans corps refusent tout contenu transmis.","version":"v1"},"servers":[{"url":"https://api.codepersist.com"}],"paths":{"/api/v1/products":{"get":{"tags":["Products"],"summary":"Lister les produits","description":"Accès en lecture seule. Parcourez votre catalogue de produits. Utilisez le paramètre de chaîne de requête `gtin` pour filtrer par numéro de code-barres. Si vous perdez une réponse de création, comparez le champ `resolverUrl` de chaque produit correspondant dans la réponse avant de réessayer.\n\nLe paramètre de chaîne de requête `limit` règle la taille des pages. Copiez `nextOffset` du corps JSON de la réponse dans le paramètre `offset` de la requête suivante et gardez le même filtre. Une valeur nulle indique la fin. Des changements simultanés peuvent déplacer les résultats entre les pages.","operationId":"CustomerV1ListProducts","parameters":[{"name":"offset","in":"query","description":"Paramètre de chaîne de requête `offset` compté à partir de zéro. Omettez-le ou indiquez 0 pour la première page. Copiez `nextOffset` du corps JSON de la réponse précédente et gardez le même filtre. Valeurs permises : 0 à 2147483546 en chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":2147483546,"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"Nombre maximal de résultats par page, de 1 à 100. Le paramètre de chaîne de requête `limit` vaut 50 par défaut. Une page peut contenir moins de résultats. Consultez `nextOffset` dans le corps JSON de la réponse pour savoir s’il reste une page. Envoyez des chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":100,"minimum":1,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":50}},{"name":"gtin","in":"query","description":"Filtrez par numéro de code-barres exact. Utilisez un GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 avec un chiffre de contrôle valide. Les espaces aux extrémités sont supprimés. Omettez le paramètre pour lister tous les GTIN. Une valeur vide est rejetée. Pour retrouver un code imprimé précis, comparez aussi le `resolverUrl` d’origine.","schema":{"type":"string"}}],"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPageOfProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]},"post":{"tags":["Products"],"summary":"Créer un produit","description":"Accès en écriture. Créez la première version enregistrée. Dans le corps JSON de la requête, fournissez `name`, un `gtin` valide et `destinationUrl`. Si vous omettez les champs facultatifs `resolverUrl`, `resources` et `barcode`, CodePersist utilise son adresse standard, crée un lien vers votre page produit et applique les réglages QR par défaut. Publiez le produit séparément lorsqu’il est prêt.\n\nLe GTIN et le résolveur d’origine sont fixés à la création. Un produit créé avec le résolveur standard peut recevoir un domaine personnalisé permanent. Après HTTP 201, conservez le champ `id` du corps JSON de la réponse. Pour publier, copiez le champ `currentVersion.id` de cette réponse dans `expectedVersionId` dans le corps de la requête de publication. L’en-tête HTTP de réponse `Location` contient le chemin relatif `/api/v1/products/{id}`. Envoyez une requête GET à ce chemin sur l’hôte de l’API. Si vous perdez la réponse, listez les produits avec le paramètre de requête `gtin` et comparez les champs `resolverUrl` des résultats avant de réessayer.","operationId":"CustomerV1CreateProduct","requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductInput"},"example":{"name":"Ground coffee 250g","gtin":"09506000134352","destinationUrl":"https://brand.example/coffee"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/CreateProductInput"},"example":{"name":"Ground coffee 250g","gtin":"09506000134352","destinationUrl":"https://brand.example/coffee"}}},"required":true},"responses":{"201":{"description":"Ressource créée. L’en-tête de réponse `Location` pointe vers la nouvelle ressource.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Location":{"description":"L’en-tête de réponse `Location` contient le chemin relatif de la ressource créée. Résolvez-le par rapport à l’hôte de l’API et envoyez une requête GET avec l’en-tête de requête `Authorization`.","schema":{"type":"string","format":"uri-reference"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}":{"get":{"tags":["Products"],"summary":"Consulter un produit","description":"Accès en lecture seule. Lisez le produit avant de le modifier, de le publier, de générer un fichier QR ou d’agir sur sa désactivation. Placez son identifiant dans le paramètre de chemin `id`. Le corps JSON de la réponse contient la dernière configuration enregistrée et l’état de publication et de désactivation.\n\nDans le corps JSON de la réponse, `currentVersion.id` désigne la configuration enregistrée, `publishedVersionId` la dernière version publiée et `removalOperationId` une tentative de désactivation. Les versions enregistrée et publiée peuvent différer. Un produit indisponible renvoie HTTP 404.","operationId":"CustomerV1GetProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]},"put":{"tags":["Products"],"summary":"Remplacer la configuration d’un produit","description":"Accès en écriture. Placez l’identifiant du produit dans le paramètre de chemin `id`. Lisez le produit et reprenez `name`, `resources` et `barcode` de l’objet `currentVersion` du corps de la réponse. Incluez ces champs dans le corps JSON de la requête, même si seul le nom change. La configuration modifiable est remplacée au complet.\n\nCopiez le champ `currentVersion.id` vérifié du corps de la réponse du produit dans `expectedVersionId` dans le corps de la requête. Après HTTP 409, relisez le produit et intégrez les changements. L’enregistrement crée une version et conserve le GTIN, le résolveur d’origine et le domaine associé. Publiez séparément pour mettre à jour le résultat des balayages.","operationId":"CustomerV1ReplaceProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceProductInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111","name":"Ground coffee 250 g","resources":{"defaultLinkId":"product-page","slots":[],"links":[{"id":"product-page","slotKey":null,"url":"https://brand.example/coffee","relations":["https://ref.gs1.org/voc/pip"],"title":"Product information","mediaType":null,"languages":[],"context":[]}],"allowAdditionalRelations":true,"hostedLandingPageEnabled":false},"barcode":{"errorCorrection":"H","xDimensionMillimetres":0.6}}},"application/*+json":{"schema":{"$ref":"#/components/schemas/ReplaceProductInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111","name":"Ground coffee 250 g","resources":{"defaultLinkId":"product-page","slots":[],"links":[{"id":"product-page","slotKey":null,"url":"https://brand.example/coffee","relations":["https://ref.gs1.org/voc/pip"],"title":"Product information","mediaType":null,"languages":[],"context":[]}],"allowAdditionalRelations":true,"hostedLandingPageEnabled":false},"barcode":{"errorCorrection":"H","xDimensionMillimetres":0.6}}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]},"delete":{"tags":["Products"],"summary":"Supprimer un produit désactivé","description":"Accès en écriture. Supprimez définitivement un produit après la fin de sa désactivation. Lisez d’abord le produit désactivé. Placez son identifiant dans le paramètre de chemin `id`. Copiez les champs `currentVersion.id` et `removalOperationId` du corps de la réponse dans les paramètres de chaîne de requête `expectedVersionId` et `expectedRemovalOperationId`, respectivement. N’envoyez aucun corps.\n\nHTTP 204 ne contient pas de corps de réponse et couvre aussi les produits déjà absents. Un changement de version ou de désactivation renvoie HTTP 409. Si la réponse est perdue ou que la suppression reste incertaine (HTTP 503), vérifiez si le produit existe avant de réessayer.","operationId":"CustomerV1DeleteProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"expectedVersionId","in":"query","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"expectedRemovalOperationId","in":"query","description":"Copiez le champ `removalOperationId` du corps JSON de la dernière réponse du produit. La réactivation et la suppression exigent une désactivation terminée. La relance exige une tentative échouée. Vérifiez le champ `status` de la réponse pour confirmer son état. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"responses":{"204":{"description":"Aucun corps de réponse.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"La suppression n’a pas pu être confirmée. Relisez le produit avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/custom-domain":{"post":{"tags":["Products"],"summary":"Associer un domaine personnalisé à un produit","description":"Accès en écriture. Ajoutez une adresse de balayage permanente à un produit activé créé avec le résolveur CodePersist. Connectez, vérifiez et activez d’abord le domaine. Placez l’identifiant du produit dans le paramètre de chemin `id`. Dans le corps JSON de la requête, transmettez l’origine HTTPS exacte dans `resolverUrl` et copiez le champ `currentVersion.id` de la réponse du produit dans `expectedVersionId`. Un produit peut recevoir un seul domaine permanent.\n\nLe corps JSON de la réponse contient le produit mis à jour, dont les champs `currentVersion` et `digitalLinkUrl`. Les aperçus utilisent cette URL aussitôt. Publiez la version pour mettre à jour les deux adresses, puis générez un fichier d’impression. Le champ `resolverUrl` d’origine et les codes imprimés conservent leurs adresses. Relisez le produit si le résultat est incertain. Un domaine indisponible ou déjà associé renvoie HTTP 400. Une version périmée ou un état incompatible renvoie HTTP 409.","operationId":"CustomerV1AttachCustomDomain","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachCustomDomainInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111","resolverUrl":"https://id.brand.example/"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/AttachCustomDomainInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111","resolverUrl":"https://id.brand.example/"}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/versions":{"get":{"tags":["Products"],"summary":"Lister les versions du produit","description":"Accès en lecture seule. Placez l’identifiant du produit dans le paramètre de chemin `id` pour parcourir les configurations enregistrées, de la plus récente à la plus ancienne. Le corps JSON de la réponse liste les versions dans `items`. Chaque version contient le nom, les destinations et les réglages QR enregistrés.\n\nUtilisez le champ de réponse `items[].number` dans le paramètre de chemin `number` lors d’une restauration. Comparez l’`id` de la version dans `items` au champ `publishedVersionId` du corps de la réponse du produit. Pour continuer, copiez `nextOffset` du corps de la réponse dans le paramètre de chaîne de requête `offset` de l’appel suivant. Le paramètre de chaîne de requête `limit` règle la taille des pages.","operationId":"CustomerV1ListVersions","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"offset","in":"query","description":"Paramètre de chaîne de requête `offset` compté à partir de zéro. Omettez-le ou indiquez 0 pour la première page. Copiez `nextOffset` du corps JSON de la réponse précédente et gardez le même filtre. Valeurs permises : 0 à 2147483546 en chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":2147483546,"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"Nombre maximal de résultats par page, de 1 à 100. Le paramètre de chaîne de requête `limit` vaut 50 par défaut. Une page peut contenir moins de résultats. Consultez `nextOffset` dans le corps JSON de la réponse pour savoir s’il reste une page. Envoyez des chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":100,"minimum":1,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPageOfVersionDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/versions/{number}/restore":{"post":{"tags":["Products"],"summary":"Restaurer une version du produit","description":"Accès en écriture. Copiez une configuration antérieure dans une nouvelle version courante. Utilisez l’identifiant du produit comme paramètre de chemin `id` et le champ `number` de la version enregistrée comme paramètre de chemin `number`. Dans le corps JSON de la requête, donnez à `expectedVersionId` la valeur de `currentVersion.id` du corps de la dernière réponse du produit.\n\nL’identité de balayage d’origine et tout domaine personnalisé permanent sont conservés. Vérifiez l’objet `currentVersion` du corps JSON de la réponse et publiez-le séparément. Après HTTP 409, relisez le produit avant de tenter la restauration.","operationId":"CustomerV1RestoreVersion","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"number","in":"path","description":"Le paramètre de chemin `number` sélectionne une entrée historique. Copiez le champ `items[].number` du corps de la réponse de liste des versions. Fournissez `expectedVersionId` séparément dans le corps JSON de la requête. Le chemin accepte 1 à 9223372036854775807 en chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","required":true,"schema":{"maximum":9223372036854775807,"minimum":1,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/VersionInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111"}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/publications":{"get":{"tags":["Products"],"summary":"Lister les tentatives de publication","description":"Accès en lecture seule. Placez l’identifiant du produit dans le paramètre de chemin `id` pour consulter ses tentatives de publication, de la plus récente à la plus ancienne. Le corps JSON de la réponse indique la version, le résultat et les heures de début ou de fin de chaque tentative.\n\nUne tentative réussie peut concerner une ancienne version. Comparez `items[].versionId` dans le corps de cette réponse à `currentVersion.id` et `publishedVersionId` dans le corps de la réponse du produit. Copiez le champ `nextOffset` dans le paramètre de chaîne de requête `offset` de l’appel suivant s’il reste une page. Le paramètre de chaîne de requête `limit` règle la taille des pages.","operationId":"CustomerV1ListPublications","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"offset","in":"query","description":"Paramètre de chaîne de requête `offset` compté à partir de zéro. Omettez-le ou indiquez 0 pour la première page. Copiez `nextOffset` du corps JSON de la réponse précédente et gardez le même filtre. Valeurs permises : 0 à 2147483546 en chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":2147483546,"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"Nombre maximal de résultats par page, de 1 à 100. Le paramètre de chaîne de requête `limit` vaut 50 par défaut. Une page peut contenir moins de résultats. Consultez `nextOffset` dans le corps JSON de la réponse pour savoir s’il reste une page. Envoyez des chiffres décimaux ASCII sans signe, espace, fraction ni exposant.","schema":{"maximum":100,"minimum":1,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPageOfPublicationDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]},"post":{"tags":["Products"],"summary":"Publier un produit","description":"Accès en écriture. Rendez la version enregistrée accessible aux personnes qui balaient le code QR. Placez l’identifiant du produit dans le paramètre de chemin `id`. Après avoir vérifié la version, copiez `currentVersion.id` de la réponse du produit dans `expectedVersionId` dans le corps JSON de la requête. La publication met à jour l’adresse d’origine et tout domaine personnalisé permanent.\n\nDans le corps JSON de la réponse, comparez `publishedVersionId` à la version que vous vouliez publier. Après un délai dépassé ou un résultat incertain, consultez le produit et son historique avant de réessayer. La reprise peut encore terminer le travail accepté.","operationId":"CustomerV1PublishProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/VersionInput"},"example":{"expectedVersionId":"11111111-1111-1111-1111-111111111111"}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/disable":{"post":{"tags":["Products"],"summary":"Désactiver un produit","description":"Accès en écriture. Mettez un produit hors ligne tout en conservant sa configuration, son historique et ses fichiers. Placez l’identifiant du produit dans le paramètre de chemin `id` et n’envoyez aucun corps. HTTP 202 confirme que le retrait est en file d’attente. Envoyez une requête GET au chemin relatif de l’en-tête de réponse `Location` pour suivre la progression.\n\nAttendez que le champ `status` du corps de la réponse du produit indique `disabled` avant de le réactiver ou de le supprimer. Si `status` indique `disableFailed`, copiez le champ `removalOperationId` de la réponse dans `expectedRemovalOperationId` dans le corps de la requête de relance. Les règles du forfait et les délais d’attente peuvent bloquer la désactivation.","operationId":"CustomerV1DisableProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"responses":{"202":{"description":"Travail accepté. Consultez le chemin du produit fourni dans l’en-tête de réponse `Location` pour suivre la progression.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Location":{"description":"L’en-tête de réponse `Location` contient le chemin relatif du produit. Envoyez une requête GET à ce chemin sur l’hôte de l’API et vérifiez le champ `status` du corps JSON de la réponse.","schema":{"type":"string","format":"uri-reference"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/enable":{"post":{"tags":["Products"],"summary":"Réactiver un produit désactivé","description":"Accès en écriture. Ramenez un produit conservé dans votre catalogue actif. Placez l’identifiant du produit dans le paramètre de chemin `id`. Attendez la fin de la désactivation, puis copiez le champ `removalOperationId` de la réponse du produit dans `expectedRemovalOperationId` dans le corps JSON de la requête. Votre forfait courant doit avoir une place disponible.\n\nLe champ JSON `status` du produit renvoyé indique `unpublished`. Vérifiez et publiez sa version courante pour rétablir l’accès au balayage. Après HTTP 409, vérifiez l’état du retrait, son identifiant et la capacité du forfait avant de réessayer.","operationId":"CustomerV1EnableProduct","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemovalInput"},"example":{"expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/RemovalInput"},"example":{"expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/disable/retry":{"post":{"tags":["Products"],"summary":"Relancer un retrait qui a échoué","description":"Accès en écriture. Mettez en file d’attente une nouvelle désactivation après un échec. Placez l’identifiant du produit dans le paramètre de chemin `id`. Lisez le produit et confirmez que le champ `status` de sa réponse vaut `disableFailed`. Copiez son champ `removalOperationId` dans `expectedRemovalOperationId` dans le corps JSON de la requête.\n\nHTTP 202 confirme la prise en charge. Pour suivre la tentative, envoyez une requête GET au chemin indiqué dans l’en-tête de réponse `Location`. Utilisez le champ `removalOperationId` du corps de la dernière réponse du produit pour toute action ultérieure. Si la tentative a été remplacée ou si l’état a changé, relisez le produit après HTTP 409.","operationId":"CustomerV1RetryDisable","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}}],"requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemovalInput"},"example":{"expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/RemovalInput"},"example":{"expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}}},"required":true},"responses":{"202":{"description":"Travail accepté. Consultez le chemin du produit fourni dans l’en-tête de réponse `Location` pour suivre la progression.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Location":{"description":"L’en-tête de réponse `Location` contient le chemin relatif du produit. Envoyez une requête GET à ce chemin sur l’hôte de l’API et vérifiez le champ `status` du corps JSON de la réponse.","schema":{"type":"string","format":"uri-reference"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDocument"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/{id}/barcodes":{"get":{"tags":["Products"],"summary":"Générer le code QR de production","description":"Accès en lecture seule. Téléchargez le SVG d’un produit publié avec une clé en lecture seule ou en lecture et écriture. Indiquez l’identifiant du produit dans le chemin et son champ currentVersion.id dans le paramètre de requête expectedVersionId. La version doit être courante et publiée. Omettez les paramètres d’étiquette facultatifs pour générer le code QR de base.\n\nLa réponse HTTP 200 transmet directement le fichier SVG. Enregistrez le corps de la réponse avec le nom indiqué dans l’en-tête Content-Disposition. CodePersist ne conserve ni le fichier ni les valeurs de l’étiquette.","operationId":"CustomerV1GenerateBarcode","parameters":[{"name":"id","in":"path","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"expectedVersionId","in":"query","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","required":true,"schema":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},{"name":"batchOrLot","in":"query","description":"Identifiant de lot (IA GS1 10), jusqu’à 20 caractères GS1 pris en charge. Envoyez une chaîne pour conserver les zéros initiaux.","schema":{"maxLength":20,"type":"string"}},{"name":"serialNumber","in":"query","description":"Numéro de série (IA GS1 21), jusqu’à 20 caractères GS1 pris en charge. Envoyez une chaîne pour conserver les zéros initiaux.","schema":{"maxLength":20,"type":"string"}},{"name":"expirationDate","in":"query","description":"Date d’expiration (IA GS1 17) au format AAAA-MM-JJ. L’année doit se situer entre 49 ans avant et 50 ans après l’année UTC courante.","schema":{"type":"string"}},{"name":"netWeightKilograms","in":"query","description":"Poids net en kilogrammes (IA GS1 3103). Utilisez un point décimal et une valeur de 0,001 à 999,999 par incréments de 0,001 kg.","schema":{"type":"string"}}],"responses":{"200":{"description":"Le corps de la réponse HTTP contient les octets SVG. L’en-tête de réponse `Content-Type` vaut `image/svg+xml`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"L’en-tête de réponse `X-Content-SHA256` contient le condensat SHA-256 du corps SVG en 64 caractères hexadécimaux minuscules.","schema":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"}},"Content-Disposition":{"description":"L’en-tête de réponse `Content-Disposition` fournit le nom du fichier SVG transmis dans le corps de la réponse.","schema":{"type":"string"}}},"content":{"image/svg+xml":{"schema":{"$ref":"#/components/schemas/Stream"}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/batch/publish":{"post":{"tags":["Products"],"summary":"Publier plusieurs produits","description":"Accès en écriture. Publiez de un à cinq produits en un appel. Dans le tableau `items` du corps JSON de la requête, associez chaque `productId` à `expectedVersionId`, copié du champ `currentVersion.id` du corps de la réponse du produit. Le service traite la sélection dans l’ordre.\n\nVérifiez chaque champ `items[].status` du corps JSON de la réponse même si le statut HTTP est 200. Les succès précédents sont conservés. Un produit indisponible reçoit la valeur individuelle 404. Si le champ `stopped` de la réponse vaut true, les éléments suivants peuvent avoir le statut 424. Consultez l’état et l’historique avant de soumettre de nouveau.","operationId":"CustomerV1BatchPublish","requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPublishRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedVersionId":"11111111-1111-1111-1111-111111111111"}]}},"application/*+json":{"schema":{"$ref":"#/components/schemas/BatchPublishRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedVersionId":"11111111-1111-1111-1111-111111111111"}]}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","status":200,"code":null}],"stopped":false}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/batch/disable":{"post":{"tags":["Products"],"summary":"Désactiver plusieurs produits","description":"Accès en écriture. Mettez en file d’attente le retrait du résolveur pour un à cinq produits distincts. Placez leurs identifiants dans le tableau `productIds` du corps JSON de la requête. Si un produit est indisponible, la requête entière renvoie HTTP 404 avant toute modification.\n\nDans le corps JSON de la réponse, un champ `items[].status` de 202 indique que le retrait du produit a été accepté. Interrogez l’opération de lecture du produit jusqu’à ce que son champ JSON `status` indique `disabled` ou `disableFailed`. Si la requête s’interrompt, certains changements peuvent avoir été acceptés. Relisez tous les produits sélectionnés avant de réessayer.","operationId":"CustomerV1BatchDisable","requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDisableRequest"},"example":{"productIds":["33333333-3333-3333-3333-333333333333"]}},"application/*+json":{"schema":{"$ref":"#/components/schemas/BatchDisableRequest"},"example":{"productIds":["33333333-3333-3333-3333-333333333333"]}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","status":202,"code":null}],"stopped":false}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/batch/enable":{"post":{"tags":["Products"],"summary":"Réactiver plusieurs produits","description":"Accès en écriture. Réactivez de un à cinq produits une fois leur désactivation terminée. Dans le tableau `items` du corps JSON de la requête, associez chaque `productId` à `expectedRemovalOperationId`, copié du champ `removalOperationId` du corps de la réponse du produit. Si un produit est indisponible, la requête entière renvoie HTTP 404 avant toute modification. Les limites du forfait courant s’appliquent.\n\nVérifiez chaque champ `items[].status` du corps JSON de la réponse. La valeur 200 indique que le produit est réactivé à l’état non publié. Publiez-le pour rétablir l’accès au balayage. Un échec peut survenir après certains succès : relisez chaque produit sélectionné avant de réessayer.","operationId":"CustomerV1BatchEnable","requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEnableRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}]}},"application/*+json":{"schema":{"$ref":"#/components/schemas/BatchEnableRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}]}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","status":200,"code":null}],"stopped":false}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}},"/api/v1/products/batch/delete":{"post":{"tags":["Products"],"summary":"Supprimer plusieurs produits désactivés","description":"Accès en écriture. Supprimez définitivement de un à cinq produits entièrement désactivés. Chaque entrée du tableau `items` dans le corps JSON de la requête doit contenir `productId`, `expectedVersionId` et `expectedRemovalOperationId`. Copiez les champs `id`, `currentVersion.id` et `removalOperationId` du corps de la réponse du produit. Un changement de version ou de désactivation peut entraîner le rejet de l’élément.\n\nVérifiez chaque champ `items[].status` dans le corps JSON de la réponse. La valeur 204 couvre les produits supprimés ou déjà absents. Les suppressions précédentes sont conservées en cas d’échec ultérieur. Si le champ `stopped` de la réponse vaut true, vérifiez l’état courant avant de réessayer.","operationId":"CustomerV1BatchDelete","requestBody":{"description":"Envoyez un corps de requête JSON en UTF-8 avec l’en-tête de requête `Content-Type` réglé à `application/json` ou à un type de média `application/*+json` pris en charge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedVersionId":"11111111-1111-1111-1111-111111111111","expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}]}},"application/*+json":{"schema":{"$ref":"#/components/schemas/BatchDeleteRequest"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","expectedVersionId":"11111111-1111-1111-1111-111111111111","expectedRemovalOperationId":"22222222-2222-2222-2222-222222222222"}]}}},"required":true},"responses":{"200":{"description":"Réussite","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"},"example":{"items":[{"productId":"33333333-3333-3333-3333-333333333333","status":204,"code":null}],"stopped":false}}}},"400":{"description":"Entrée invalide. Le corps JSON de la réponse Problem Details peut contenir un champ `code` et un objet `errors` indexé par champ d’entrée.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"401":{"description":"La clé API de l’en-tête de requête `Authorization` est absente, invalide, expirée ou révoquée. La réponse inclut l’en-tête `WWW-Authenticate`.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"L’en-tête de réponse `WWW-Authenticate` vaut `Bearer` sur HTTP 401. Envoyez une clé API valide dans l’en-tête de requête `Authorization`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"La clé d’API ne dispose pas de l’autorisation d’écriture, du forfait ou de l’accès à l’organisation requis.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"La ressource est indisponible.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"La version ou la tentative de désactivation vérifiée a changé, ou une règle du cycle de vie ou de capacité bloque l’action. Relisez le produit avant de réessayer. Le corps JSON d’une erreur de délai de désactivation peut contenir le champ `nextDisableAtUtc`, qui indique la prochaine heure admissible en UTC.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"413":{"description":"Le corps JSON dépasse 256 Kio.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"415":{"description":"Réglez l’en-tête de requête `Content-Type` à `application/json` ou à un type de média `application/*+json` pris en charge et envoyez un corps JSON en UTF-8.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Limite de requêtes de l’organisation dépassée. Attendez le nombre de secondes indiqué dans l’en-tête de réponse `Retry-After` avant de réessayer.","headers":{"X-Activity-Id":{"description":"L’en-tête de réponse `X-Activity-Id` identifie cette requête. Communiquez-le au soutien technique si vous signalez un problème. Lorsque le corps de réponse Problem Details contient un champ `traceId`, les deux valeurs désignent la même requête.","schema":{"type":"string"}},"Retry-After":{"description":"L’en-tête de réponse `Retry-After` indique le nombre de secondes à attendre avant de réessayer.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"security":[{"CustomerApiKey":[]}]}}},"components":{"schemas":{"AttachCustomDomainInput":{"title":"Demande d’association de domaine","required":["expectedVersionId","resolverUrl"],"type":"object","properties":{"expectedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"resolverUrl":{"type":"string","description":"Origine HTTPS obligatoire et non nulle d’un domaine personnalisé déjà connecté, vérifié et actif. Utilisez un nom d’hôte ASCII, en punycode au besoin, sans données d’authentification, chemin autre que la racine, requête ni fragment. L’origine normalisée, y compris son port, doit correspondre exactement au domaine connecté. Aucun identifiant de domaine n’est requis. À la différence de la création, l’omission et null ne sélectionnent aucune valeur par défaut.","format":"uri"}},"additionalProperties":false,"description":"Corps JSON de la requête d’association d’un domaine actif déjà connecté. Fournissez `resolverUrl` et `expectedVersionId` comme champs non nuls. La version `currentVersion` du corps JSON de la réponse doit être publiée séparément pour activer les deux adresses."},"BarcodeSettings":{"title":"Réglages du code QR","type":"object","properties":{"errorCorrection":{"enum":["L","M","Q","H"],"type":"string","description":"Niveau de correction QR sensible à la casse, parmi L, M, Q et H. La valeur par défaut est M. Les valeurs numériques et null sont refusées.","default":"M"},"xDimensionMillimetres":{"multipleOf":0.001,"maximum":0.990,"minimum":0.396,"pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$","type":"number","description":"Largeur du module QR en nombre JSON, de 0,396 à 0,990 millimètre par incréments de 0,001. La valeur doit être représentable exactement en décimal. La précision excédentaire est refusée. Les exposants et les zéros de fin sont acceptés si la valeur est exacte. La valeur par défaut est 0,495. Les nombres entre guillemets et null sont refusés.","format":"double","default":0.495}},"additionalProperties":false,"description":"Paramètres du code QR Digital Link. La sortie de production est au format SVG et les dimensions sont en millimètres."},"BatchDeleteRequest":{"title":"Demande de suppression groupée","required":["items"],"type":"object","properties":{"items":{"maxItems":5,"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ProductDeletionSelection"},"description":"Fournissez de une à cinq entrées avec des identifiants de produit distincts. Incluez chaque produit une seule fois, même s’il a plusieurs versions ou tentatives de désactivation. Une sélection invalide ou en double renvoie 400 avant le traitement. Vérifiez le résultat de chaque produit sélectionné."}},"additionalProperties":false,"description":"Corps JSON de la requête avec un à cinq produits distincts dans le tableau `items`. Pour chaque entrée, indiquez `productId` ainsi que la version et la désactivation terminée dans `expectedVersionId` et `expectedRemovalOperationId`."},"BatchDisableRequest":{"title":"Demande de désactivation groupée","required":["productIds"],"type":"object","properties":{"productIds":{"maxItems":5,"minItems":1,"uniqueItems":true,"type":"array","items":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant opaque. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"description":"Fournissez de une à cinq entrées avec des identifiants de produit distincts. Incluez chaque produit une seule fois, même s’il a plusieurs versions ou tentatives de désactivation. Une sélection invalide ou en double renvoie 400 avant le traitement. Vérifiez le résultat de chaque produit sélectionné."}},"additionalProperties":false,"description":"Corps JSON de la requête avec un à cinq identifiants de produit distincts dans le tableau `productIds`. Copiez chaque identifiant du champ `id` d’une réponse de produit."},"BatchEnableRequest":{"title":"Demande de réactivation groupée","required":["items"],"type":"object","properties":{"items":{"maxItems":5,"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ProductRemovalSelection"},"description":"Fournissez de une à cinq entrées avec des identifiants de produit distincts. Incluez chaque produit une seule fois, même s’il a plusieurs versions ou tentatives de désactivation. Une sélection invalide ou en double renvoie 400 avant le traitement. Vérifiez le résultat de chaque produit sélectionné."}},"additionalProperties":false,"description":"Corps JSON de la requête avec un à cinq produits distincts dans le tableau `items`. Pour chaque entrée, indiquez `productId` et copiez le champ `removalOperationId` de la réponse du produit dans `expectedRemovalOperationId`."},"BatchItemResult":{"title":"Résultat pour un produit","required":["productId","status"],"type":"object","properties":{"productId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant du produit dans la sélection soumise. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"status":{"pattern":"^-?(?:0|[1-9]\\d*)$","enum":[200,202,204,400,401,403,404,409,424,503],"type":"integer","description":"Statut HTTP propre au produit, indépendant de la réponse HTTP 200 globale. Vérifiez chaque élément pour confirmer la réussite du lot.","format":"int32"},"code":{"type":["null","string"],"description":"Code d’erreur stable et facultatif. La réponse exclut les données de diagnostic et les identifiants du fournisseur."}},"description":"Résultat pour un produit, selon les statuts HTTP. 200 réactivé ou publié, 202 retrait accepté, 204 supprimé ou absent, 400 invalide, 401 clé devenue invalide, 403 accès refusé, 404 introuvable, 409 conflit, 424 non tenté ou 503 résultat incertain."},"BatchPublishRequest":{"title":"Demande de publication groupée","required":["items"],"type":"object","properties":{"items":{"maxItems":5,"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ProductVersionSelection"},"description":"Fournissez de une à cinq entrées avec des identifiants de produit distincts. Incluez chaque produit une seule fois, même s’il a plusieurs versions ou tentatives de désactivation. Une sélection invalide ou en double renvoie 400 avant le traitement. Vérifiez le résultat de chaque produit sélectionné."}},"additionalProperties":false,"description":"Corps JSON de la requête avec un à cinq produits distincts dans le tableau `items`. Pour chaque entrée, copiez le champ `id` de la réponse du produit dans `productId` et `currentVersion.id` dans `expectedVersionId`."},"BatchResult":{"title":"Résultats du traitement groupé","required":["items"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BatchItemResult"},"description":"Résultats dans le corps JSON de la réponse, un par produit dans l’ordre de la requête. Associez le champ `productId` de chaque élément au produit soumis. Vérifiez les champs de réponse `status` et `code` de l’élément avant de réessayer."},"stopped":{"type":"boolean","description":"Vaut true si le traitement s’est arrêté avant la confirmation de tous les éléments soumis. Relisez l’état actuel avant de réessayer.","default":false}},"description":"Corps JSON de la réponse avec un résultat par produit soumis. HTTP 200 décrit la requête groupée dans son ensemble. Vérifiez chaque champ `items[].status` et le champ `stopped` du corps de la réponse. Les succès sont conservés."},"CollectionPageOfProductDocument":{"title":"Page de produits","required":["items","nextOffset"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductDocument"},"description":"Résultats dans le corps JSON de la réponse, dans l’ordre indiqué. Si le champ `nextOffset` est présent et non nul, utilisez-le dans le paramètre de chaîne de requête `offset` de l’appel suivant."},"nextOffset":{"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":["null","integer"],"description":"Copiez ce champ de réponse JSON dans le paramètre de chaîne de requête `offset` pour obtenir la page suivante. Une valeur nulle indique la dernière page.","format":"int32"}},"description":"Corps JSON de la réponse contenant les produits correspondants dans `items` et la position de la page suivante dans `nextOffset`."},"CollectionPageOfPublicationDocument":{"title":"Page de tentatives de publication","required":["items","nextOffset"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicationDocument"},"description":"Résultats dans le corps JSON de la réponse, dans l’ordre indiqué. Si le champ `nextOffset` est présent et non nul, utilisez-le dans le paramètre de chaîne de requête `offset` de l’appel suivant."},"nextOffset":{"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":["null","integer"],"description":"Copiez ce champ de réponse JSON dans le paramètre de chaîne de requête `offset` pour obtenir la page suivante. Une valeur nulle indique la dernière page.","format":"int32"}},"description":"Corps JSON de la réponse contenant les tentatives de publication dans `items`, de la plus récente à la plus ancienne, et la position de la page suivante dans `nextOffset`."},"CollectionPageOfVersionDocument":{"title":"Page de versions du produit","required":["items","nextOffset"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/VersionDocument"},"description":"Résultats dans le corps JSON de la réponse, dans l’ordre indiqué. Si le champ `nextOffset` est présent et non nul, utilisez-le dans le paramètre de chaîne de requête `offset` de l’appel suivant."},"nextOffset":{"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":["null","integer"],"description":"Copiez ce champ de réponse JSON dans le paramètre de chaîne de requête `offset` pour obtenir la page suivante. Une valeur nulle indique la dernière page.","format":"int32"}},"description":"Corps JSON de la réponse contenant les versions enregistrées dans `items`, de la plus récente à la plus ancienne, et la position de la page suivante dans `nextOffset`."},"CreateProductInput":{"title":"Détails du nouveau produit","required":["name","gtin","destinationUrl"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Nom utilisé par votre équipe pour reconnaître le produit, par exemple Café moulu 250 g. Le service retire les espaces aux extrémités et exige de 1 à 200 caractères après ce retrait. Fournissez le nom lors du remplacement même s’il reste inchangé."},"gtin":{"type":"string","description":"Numéro d’article commercial mondial du code-barres. Transmettez-le comme chaîne pour conserver les zéros initiaux. Le service accepte les GTIN-8, GTIN-12, GTIN-13 et GTIN-14 en chiffres ASCII avec un chiffre de contrôle valide, retire les espaces aux extrémités et renvoie la forme à 14 chiffres complétée par des zéros. Le GTIN est fixé à la création."},"destinationUrl":{"type":"string","description":"Adresse de la page ou de la ressource à ouvrir, par exemple `https://brand.example/coffee`. Fournissez une URL HTTP ou HTTPS absolue avec un hôte, sans identifiants de connexion. L’URL normalisée peut contenir jusqu’à 2048 caractères. Les destinations Unicode sont prises en charge.","format":"uri"},"resolverUrl":{"type":["null","string"],"description":"Origine HTTPS initiale immuable du résolveur, avec un nom d’hôte ASCII, sans données d’authentification, chemin autre que la racine, requête ni fragment. Utilisez le punycode pour un nom internationalisé. Un résolveur personnalisé doit déjà être connecté et disponible. L’omission ou null à la création sélectionne le résolveur par défaut. Ce champ reste identique si un domaine personnalisé est ajouté plus tard par l’API, l’application ou l’importation Excel.","format":"uri"},"resources":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ResourceSet"}]},"barcode":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BarcodeSettings"}]}},"additionalProperties":false,"description":"Corps JSON de la requête de création d’un produit non publié. Les champs `name`, `gtin` et `destinationUrl` sont obligatoires et non nuls. Omettez `resolverUrl` ou utilisez null pour choisir le résolveur standard. Omettez `resources` ou utilisez null pour créer un lien standard à partir de `destinationUrl`. Si l’objet `resources` est fourni, il détermine les destinations enregistrées. Le champ `destinationUrl` reste obligatoire et validé. Omettez `barcode` ou utilisez null pour les réglages QR par défaut."},"CustomerProductStatus":{"title":"État du produit","enum":["unpublished","publishing","published","publishFailed","disabling","disabled","disableFailed"],"type":"string","description":"État du cycle de vie dans le champ `status` du corps JSON de la réponse du produit. Comparez-le à `publishedVersionId` pour distinguer la dernière version enregistrée de la dernière publication réussie. Après la mise en file du retrait, consultez le produit jusqu’à ce que `status` indique `disabled` ou `disableFailed`."},"CustomerPublicationStatus":{"title":"État de la tentative de publication","enum":["inProgress","succeeded","failed"],"type":"string","description":"Champ `status` d’une tentative de publication dans le corps JSON de la réponse. Une tentative `succeeded` concerne le `versionId` de cette entrée. Consultez la réponse du produit pour connaître la dernière version publiée."},"ProblemDetails":{"title":"Détails de l’erreur API","type":"object","properties":{"type":{"type":["null","string"],"description":"URI qui identifie la catégorie du problème lorsqu’elle est fournie dans le corps JSON de la réponse."},"title":{"type":["null","string"],"description":"Bref résumé lisible du problème dans le corps JSON de la réponse."},"status":{"pattern":"^-?(?:0|[1-9]\\d*)$","type":["null","integer","string"],"description":"Statut HTTP répété dans le corps JSON de la réponse Problem Details lorsqu’il est fourni.","format":"int32"},"detail":{"type":["null","string"],"description":"Détails lisibles sur cette occurrence du problème lorsqu’ils sont fournis dans le corps JSON de la réponse."},"instance":{"type":["null","string"],"description":"URI qui identifie cette occurrence du problème lorsqu’elle est fournie dans le corps JSON de la réponse."},"code":{"type":"string","description":"Identifiant stable de l’erreur dans le corps JSON de la réponse Problem Details lorsqu’il est disponible. Utilisez ce champ pour distinguer les erreurs qui partagent le même statut HTTP."},"traceId":{"type":"string","description":"Identifiant de la requête dans le corps JSON de la réponse Problem Details. Il correspond à l’en-tête de réponse `X-Activity-Id` lorsque les deux sont présents."},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Messages de validation dans le corps JSON de la réponse Problem Details. Chaque clé identifie un champ d’entrée public et correspond à un tableau de messages."}},"description":"Réponse JSON d’erreur. Vérifiez d’abord le statut HTTP. Lorsqu’ils sont présents, le champ `code` du corps identifie l’erreur, `errors` liste les messages de validation et `traceId` établit la correspondance avec l’en-tête de réponse `X-Activity-Id`."},"ProductDeletionSelection":{"title":"Produit sélectionné pour la suppression","required":["productId","expectedVersionId","expectedRemovalOperationId"],"type":"object","properties":{"productId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"expectedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"expectedRemovalOperationId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `removalOperationId` du corps JSON de la dernière réponse du produit. La réactivation et la suppression exigent une désactivation terminée. La relance exige une tentative échouée. Vérifiez le champ `status` de la réponse pour confirmer son état. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"additionalProperties":false,"description":"Un objet du tableau `items` du corps JSON de la requête de suppression groupée. Il identifie le produit et confirme la version courante ainsi que la désactivation terminée."},"ProductDocument":{"title":"Produit","required":["id","gtin","resolverUrl","digitalLinkUrl","status","currentVersion","publishedVersionId","publishedAtUtc","removalOperationId"],"type":"object","properties":{"id":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant du produit. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"gtin":{"maxLength":14,"minLength":14,"pattern":"^[0-9]{14}$","type":"string","description":"Numéro d’article commercial mondial du code-barres. Transmettez-le comme chaîne pour conserver les zéros initiaux. Le service accepte les GTIN-8, GTIN-12, GTIN-13 et GTIN-14 en chiffres ASCII avec un chiffre de contrôle valide, retire les espaces aux extrémités et renvoie la forme à 14 chiffres complétée par des zéros. Le GTIN est fixé à la création."},"resolverUrl":{"type":"string","description":"Origine HTTPS initiale immuable du résolveur, avec un nom d’hôte ASCII, sans données d’authentification, chemin autre que la racine, requête ni fragment. Utilisez le punycode pour un nom internationalisé. Un résolveur personnalisé doit déjà être connecté et disponible. L’omission ou null à la création sélectionne le résolveur par défaut. Ce champ reste identique si un domaine personnalisé est ajouté plus tard par l’API, l’application ou l’importation Excel.","format":"uri"},"digitalLinkUrl":{"type":"string","description":"URL GS1 Digital Link encodée dans les codes de production de la version enregistrée. Elle change lorsqu’un domaine personnalisé est ajouté de façon permanente par l’API, l’application ou l’importation Excel. resolverUrl conserve l’origine initiale. La publication met à jour les deux adresses et permet de générer un nouveau code de production. Les codes déjà générés conservent leur URL.","format":"uri"},"status":{"$ref":"#/components/schemas/CustomerProductStatus"},"currentVersion":{"$ref":"#/components/schemas/VersionDocument"},"publishedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":["null","string"],"description":"Identifiant de la dernière version publiée avec succès, ou null si aucune version n’a été publiée. Comparez ce champ à `currentVersion.id` dans le même corps JSON de réponse pour savoir si la version enregistrée a été publiée. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"publishedAtUtc":{"maxLength":27,"minLength":27,"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$","type":["null","string"],"description":"Date et heure UTC de la dernière publication réussie, au format yyyy-MM-dd'T'HH:mm:ss.ffffff'Z' avec six décimales. Vaut null si aucune version n’a été publiée. Champ de réponse.","format":"date-time","readOnly":true},"removalOperationId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":["null","string"],"description":"Identifiant de la tentative de désactivation dans ce corps JSON de réponse. Copiez-le dans le champ de requête JSON `expectedRemovalOperationId` pour une réactivation ou une relance, ou dans le paramètre de chaîne de requête `expectedRemovalOperationId` pour supprimer un seul produit. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"description":"Corps JSON de la réponse pour un produit. L’objet `currentVersion` contient la dernière configuration enregistrée. Le champ `resolverUrl` identifie l’origine de balayage et `digitalLinkUrl` contient l’URL encodée dans le fichier de la version courante. Consultez le champ `publishedVersionId` pour connaître la dernière version publiée."},"ProductRemovalSelection":{"title":"Produit sélectionné pour la réactivation","required":["productId","expectedRemovalOperationId"],"type":"object","properties":{"productId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"expectedRemovalOperationId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `removalOperationId` du corps JSON de la dernière réponse du produit. La réactivation et la suppression exigent une désactivation terminée. La relance exige une tentative échouée. Vérifiez le champ `status` de la réponse pour confirmer son état. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"additionalProperties":false,"description":"Un objet du tableau `items` du corps JSON de la requête de réactivation groupée. Il identifie le produit et sa désactivation terminée."},"ProductVersionSelection":{"title":"Produit et version à publier","required":["productId","expectedVersionId"],"type":"object","properties":{"productId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `id` du corps JSON de la réponse du produit ou de l’élément correspondant d’une liste. Utilisez-le dans le paramètre de chemin `id` pour un seul produit ou dans le corps de la requête groupée. Il est distinct du GTIN et des identifiants de version et de fichier. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"expectedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"additionalProperties":false,"description":"Un objet du tableau `items` du corps JSON de la requête de publication groupée. Il identifie le produit et la version enregistrée à publier."},"PublicationDocument":{"title":"Tentative de publication","required":["id","versionId","status","startedAtUtc","completedAtUtc"],"type":"object","properties":{"id":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant de la tentative de publication. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"versionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Version du produit visée par cette tentative. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"status":{"$ref":"#/components/schemas/CustomerPublicationStatus"},"startedAtUtc":{"maxLength":27,"minLength":27,"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$","type":"string","description":"Date et heure UTC du début de publication, attribuées par le serveur, au format yyyy-MM-dd'T'HH:mm:ss.ffffff'Z' avec six décimales. Champ de réponse.","format":"date-time","readOnly":true},"completedAtUtc":{"maxLength":27,"minLength":27,"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$","type":["null","string"],"description":"Date et heure UTC de fin de publication, au format yyyy-MM-dd'T'HH:mm:ss.ffffff'Z' avec six décimales. Vaut null tant que la publication est en cours. Champ de réponse.","format":"date-time","readOnly":true}},"description":"Tentative de publication. Les détails du fournisseur restent privés. Consultez le produit pour connaître sa version actuellement publiée."},"RemovalInput":{"title":"Désactivation à confirmer","required":["expectedRemovalOperationId"],"type":"object","properties":{"expectedRemovalOperationId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `removalOperationId` du corps JSON de la dernière réponse du produit. La réactivation et la suppression exigent une désactivation terminée. La relance exige une tentative échouée. Vérifiez le champ `status` de la réponse pour confirmer son état. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"additionalProperties":false,"description":"Corps JSON de la requête contenant le champ `expectedRemovalOperationId`. Copiez sa valeur de `removalOperationId` dans le corps de la dernière réponse du produit. HTTP 409 signifie que l’identifiant de désactivation ou l’état du produit ne permet plus l’action."},"ReplaceProductInput":{"title":"Configuration produit mise à jour","required":["expectedVersionId","name","resources","barcode"],"type":"object","properties":{"expectedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"name":{"minLength":1,"type":"string","description":"Nom utilisé par votre équipe pour reconnaître le produit, par exemple Café moulu 250 g. Le service retire les espaces aux extrémités et exige de 1 à 200 caractères après ce retrait. Fournissez le nom lors du remplacement même s’il reste inchangé."},"resources":{"$ref":"#/components/schemas/ResourceSet"},"barcode":{"$ref":"#/components/schemas/BarcodeSettings"}},"additionalProperties":false,"description":"Corps JSON de la requête qui remplace toute la configuration modifiable et ajoute une version, même si les valeurs restent inchangées. Copiez `name`, `resources` et `barcode` depuis `currentVersion` dans le corps de la réponse du produit, puis appliquez vos modifications. Copiez `currentVersion.id` dans le champ de requête `expectedVersionId`."},"ResourceLink":{"title":"Lien de destination du balayage","required":["id","slotKey","url","relations","title","mediaType","languages","context"],"type":"object","properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]{0,99}$(?![\\s\\S])","type":"string","description":"Identifiant local stable. Les valeurs non nulles contiennent de 1 à 100 lettres ASCII minuscules, chiffres ou traits d’union, en commençant par une lettre ou un chiffre. Les espaces ne sont pas retirés."},"slotKey":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]{0,99}$(?![\\s\\S])","type":["null","string"],"description":"Champ obligatoire contenant la clé de la rubrique du lien, ou null si le lien est hors rubrique. Les valeurs non nulles contiennent de 1 à 100 lettres ASCII minuscules, chiffres ou traits d’union, en commençant par une lettre ou un chiffre. Les espaces ne sont pas retirés."},"url":{"type":"string","description":"Adresse de la page ou de la ressource à ouvrir, par exemple `https://brand.example/coffee`. Fournissez une URL HTTP ou HTTPS absolue avec un hôte, sans identifiants de connexion. L’URL normalisée peut contenir jusqu’à 2048 caractères. Les destinations Unicode sont prises en charge.","format":"uri"},"relations":{"maxItems":8,"minItems":1,"type":"array","items":{"type":"string","description":"URI de relation HTTP ou HTTPS absolue, avec un hôte, sans données d’authentification et d’au plus 300 caractères après normalisation. Les alias gs1: suivants sont développés sous https://ref.gs1.org/voc/ : pip, allergenInfo, ingredientsInfo, nutritionalInfo, instructions, certificationInfo, safetyInfo, quickStartGuide, tutorial, consumerHandlingStorageInfo, recallStatus, registerProduct, serviceInfo, support et verificationService. Les alias sont sensibles à la casse. Les URI GS1 exactes defaultLink et defaultLinkMulti sont réservées. Les fragments sont significatifs et les doublons canoniques exacts sont retirés.","format":"uri"},"description":"De une à huit URI de relation descriptives. Les alias gs1: sont développés et les doublons canoniques exacts sont retirés. Les fragments sont significatifs."},"title":{"maxLength":200,"minLength":1,"type":"string","description":"Texte affiché pour ce lien de destination. Fournissez un texte non vide d’au plus 200 caractères avant le retrait des espaces. La valeur enregistrée omet les espaces aux extrémités."},"mediaType":{"type":["null","string"],"description":"Type/sous-type sans paramètres ni caractères génériques, stocké en minuscules après le retrait des espaces en début et en fin. Chaque partie compte de 1 à 127 caractères, et l’ensemble au plus 255. Le type accepte les lettres et chiffres ASCII ainsi que le trait de soulignement. Le sous-type accepte aussi le trait d’union, le signe plus et le point. Les suggestions de rubrique sont dédupliquées après normalisation. Champ obligatoire. La valeur null signifie qu’aucun type n’est spécifié."},"languages":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string","description":"Code de langue à deux lettres, avec région facultative à deux lettres, par exemple en ou en-CA. Les espaces en début et en fin sont retirés. Les deux casses sont acceptées. Les autres formes d’étiquettes de langue ne sont pas prises en charge."},"description":"De zéro à huit codes de langue à deux lettres, suivis au besoin d’un trait d’union et d’une région à deux lettres. Les espaces en début et en fin sont retirés. Les majuscules et les minuscules sont acceptées. Ces codes sont indépendants de la langue de l’appelant."},"context":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string","description":"Descripteur de contexte de 1 à 100 caractères après le retrait des espaces en début et en fin. Une valeur composée uniquement d’espaces est refusée."},"description":"De zéro à huit descripteurs de contexte comptant de 1 à 100 caractères après le retrait des espaces en début et en fin. Conservez-les lors du remplacement."}},"additionalProperties":false,"description":"Un objet du tableau `resources.links`. Dans un corps JSON de requête qui fournit des ressources, incluez tous les champs du lien. Les champs `slotKey` et `mediaType` peuvent être nuls. Les fragments d’URI dans le tableau `relations` sont significatifs."},"ResourceSet":{"title":"Destinations et règles de balayage","required":["defaultLinkId","slots","links","allowAdditionalRelations","hostedLandingPageEnabled"],"type":"object","properties":{"defaultLinkId":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]{0,99}$(?![\\s\\S])","type":"string","description":"Identifiant du lien de destination par défaut lors d’un balayage. Ce lien doit figurer dans cet ensemble. Les valeurs non nulles contiennent de 1 à 100 lettres ASCII minuscules, chiffres ou traits d’union, en commençant par une lettre ou un chiffre. Les espaces ne sont pas retirés."},"slots":{"maxItems":16,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/ResourceSlot"},"description":"De zéro à seize rubriques enregistrées et leurs règles, avec des clés uniques. Conservez la collection complète lors du remplacement."},"links":{"maxItems":32,"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ResourceLink"},"description":"De un à trente-deux liens aux identifiants uniques, dont le lien obligatoire product-page. Conservez la collection complète lors du remplacement."},"allowAdditionalRelations":{"type":"boolean","description":"Indique si des liens peuvent être ajoutés en dehors des rubriques enregistrées. Le lien product-page est toujours permis. Booléen obligatoire, sans valeur par défaut."},"hostedLandingPageEnabled":{"type":"boolean","description":"Indique si le balayage affiche une page hébergée proposant les liens enregistrés du produit."}},"additionalProperties":false,"description":"Objet `resources` dans le corps JSON d’une création ou d’un remplacement et dans la réponse d’une version enregistrée. Conservez l’objet complet lors d’un remplacement. Le tableau `links` doit contenir un lien dont `id` vaut `product-page` et dont `relations` contient `https://ref.gs1.org/voc/pip`. Les identifiants de liens et les clés de sujets doivent être uniques. Le champ `defaultLinkId` doit désigner un lien configuré. Le champ non nul `slotKey` d’un lien doit correspondre au champ `key` d’un sujet, et son tableau `relations` doit contenir le `relationUri` du sujet. Le nombre de liens affectés doit respecter `minimumLinks` et `maximumLinks`."},"ResourceSlot":{"title":"Sujet de destination du balayage","required":["key","relationUri","label","minimumLinks","maximumLinks","mediaTypeHints"],"type":"object","properties":{"key":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]{0,99}$(?![\\s\\S])","type":"string","description":"Identifiant local stable. Les valeurs non nulles contiennent de 1 à 100 lettres ASCII minuscules, chiffres ou traits d’union, en commençant par une lettre ou un chiffre. Les espaces ne sont pas retirés."},"relationUri":{"type":"string","description":"URI de relation HTTP ou HTTPS absolue, avec un hôte, sans données d’authentification et d’au plus 300 caractères après normalisation. Les alias gs1: suivants sont développés sous https://ref.gs1.org/voc/ : pip, allergenInfo, ingredientsInfo, nutritionalInfo, instructions, certificationInfo, safetyInfo, quickStartGuide, tutorial, consumerHandlingStorageInfo, recallStatus, registerProduct, serviceInfo, support et verificationService. Les alias sont sensibles à la casse. Les URI GS1 exactes defaultLink et defaultLinkMulti sont réservées. Les fragments sont significatifs et les doublons canoniques exacts sont retirés.","format":"uri"},"label":{"maxLength":100,"minLength":1,"type":"string","description":"Texte non vide d’au plus 100 caractères avant le retrait des espaces en début et en fin."},"minimumLinks":{"maximum":4,"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","description":"Entier de 0 à 4, sans point décimal ni exposant. minimumLinks ne doit pas dépasser maximumLinks. Le nombre de liens de la rubrique doit respecter les deux bornes.","format":"int32"},"maximumLinks":{"maximum":4,"minimum":0,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","description":"Entier de 0 à 4, sans point décimal ni exposant. minimumLinks ne doit pas dépasser maximumLinks. Le nombre de liens de la rubrique doit respecter les deux bornes.","format":"int32"},"mediaTypeHints":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string","description":"Type/sous-type sans paramètres ni caractères génériques, stocké en minuscules après le retrait des espaces en début et en fin. Chaque partie compte de 1 à 127 caractères, et l’ensemble au plus 255. Le type accepte les lettres et chiffres ASCII ainsi que le trait de soulignement. Le sous-type accepte aussi le trait d’union, le signe plus et le point. Les suggestions de rubrique sont dédupliquées après normalisation."},"description":"De zéro à huit suggestions de types de média sans paramètres. Les doublons normalisés sont retirés. Les liens peuvent utiliser un autre type."}},"additionalProperties":false,"description":"Rubrique et règles de lien enregistrées avec la version du produit. Conservez ces règles lors de la modification des liens."},"Stream":{"title":"Image SVG","type":"string","description":"Octets SVG dans le corps de la réponse HTTP. L’en-tête de réponse `Content-Type` vaut `image/svg+xml`.","format":"binary"},"VersionDocument":{"title":"Version enregistrée du produit","required":["id","number","name","resources","barcode","basedOnVersionId","createdAtUtc"],"type":"object","properties":{"id":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Identifiant de la version immuable du produit. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"number":{"maximum":9223372036854775807,"minimum":1,"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","description":"Numéro dans la réponse JSON de version. Copiez ce champ dans le paramètre de chemin `number` de la restauration pour sélectionner la configuration source. Utilisez `currentVersion.id` du corps de la réponse du produit pour `expectedVersionId` dans le corps de la requête de restauration.","format":"int64"},"name":{"maxLength":200,"minLength":1,"type":"string","description":"Nom utilisé par votre équipe pour reconnaître le produit, par exemple Café moulu 250 g. Le service retire les espaces aux extrémités et exige de 1 à 200 caractères après ce retrait. Fournissez le nom lors du remplacement même s’il reste inchangé."},"resources":{"$ref":"#/components/schemas/ResourceSet"},"barcode":{"$ref":"#/components/schemas/BarcodeSettings"},"basedOnVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":["null","string"],"description":"Identifiant de la version historique copiée lors d’une restauration, le cas échéant. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"},"createdAtUtc":{"maxLength":27,"minLength":27,"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$","type":"string","description":"Date et heure UTC de création de la version, attribuées par le serveur, au format yyyy-MM-dd'T'HH:mm:ss.ffffff'Z' avec six décimales. Champ de réponse.","format":"date-time","readOnly":true}},"description":"Une configuration enregistrée du produit. Elle figure dans `currentVersion` dans le corps JSON de la réponse du produit et dans `items` dans l’historique. Utilisez l’`id` de la version courante pour `expectedVersionId`. Utilisez le champ `number` historique comme paramètre de chemin `number` lors d’une restauration."},"VersionInput":{"title":"Version courante à confirmer","required":["expectedVersionId"],"type":"object","properties":{"expectedVersionId":{"maxLength":36,"minLength":36,"pattern":"^(?!00000000-0000-0000-0000-000000000000$)[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string","description":"Copiez le champ `currentVersion.id` du corps JSON de la dernière réponse du produit après avoir vérifié sa configuration. Il confirme la version sur laquelle vous agissez. Si la version courante a changé, relisez le produit après HTTP 409 et vérifiez-le avant de réessayer. UUID non nul de 36 caractères avec traits d’union. L’entrée accepte les deux casses hexadécimales. Les réponses utilisent les minuscules.","format":"uuid"}},"additionalProperties":false,"description":"Corps JSON de la requête contenant le champ `expectedVersionId`. Copiez sa valeur de `currentVersion.id` dans le corps de la dernière réponse du produit. Une version qui a changé est rejetée avec HTTP 409."}},"securitySchemes":{"CustomerApiKey":{"type":"http","description":"Envoyez un seul en-tête HTTP de requête `Authorization` sous la forme `Authorization: Bearer YOUR_API_KEY`. Remplacez `YOUR_API_KEY` par votre clé API. Utilisez une clé en lecture et écriture pour les opérations qui exigent un accès en écriture.","scheme":"bearer","bearerFormat":"CodePersist API key"}}},"tags":[{"name":"Products","x-displayName":"Produits"}]}