{"openapi":"3.1.0","info":{"title":"Shopymake API","version":"1.0.0"},"servers":[{"url":"https://shopymake.app/api/v1"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Clé API `smk_...`"}}},"paths":{"/shops/{shopId}/shopymake-theme/design/competitor":{"post":{"operationId":"shopymakeTheme.matchCompetitorDesign","summary":"Reprend le style d’une page concurrente (couleurs, bouton d’achat, polices, bandeau d’annonce) mesuré sur la page rendue, et l’applique à un thème Shopymake non publié. Publier le thème pour l’afficher.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"url":{"type":"string","maxLength":2000,"format":"uri"}},"required":["shopId","themeId","url"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean"]}},"skipped":{"type":"array","items":{"type":"string"}}},"required":["values","skipped"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/market-pricing":{"get":{"operationId":"marketPricing.get","summary":"Marchés de la boutique avec leur devise, leur règle de prix (conversion Shopify ou prix ronds), le taux du jour et un exemple de prix.","tags":["marketPricing"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopCurrency":{"type":"string"},"storeRule":{"type":"object","properties":{"mode":{"type":"string","enum":["shopify","round"]},"ending":{"type":"string","enum":["90","95","99","4.90","00"]},"adjustmentBp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","ending","adjustmentBp"],"additionalProperties":false},"uniform":{"type":"boolean"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"active":{"type":"boolean"},"currency":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"primary":{"type":"boolean"},"rule":{"type":"object","properties":{"mode":{"type":"string","enum":["shopify","round"]},"ending":{"type":"string","enum":["90","95","99","4.90","00"]},"adjustmentBp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"appliedAt":{"anyOf":[{},{"type":"null"}]}},"required":["mode","ending","adjustmentBp","appliedAt"],"additionalProperties":false},"rate":{"type":["number","null"]},"example":{"type":"object","properties":{"base":{"type":"number"},"price":{"type":["number","null"]}},"required":["base","price"],"additionalProperties":false}},"required":["id","name","active","currency","countries","primary","rule","rate","example"],"additionalProperties":false}}},"required":["shopCurrency","storeRule","uniform","markets"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"patch":{"operationId":"marketPricing.updateStoreRule","summary":"Règle de prix de la boutique, appliquée à tous les marchés hors devise de la boutique (et aux marchés créés ensuite) : `shopify` (conversion et arrondi de Shopify) ou `round` (prix ronds : terminaison, ajustement en points de base). Lancer ensuite marketPricing.apply.","tags":["marketPricing"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["shopify","round"]},"ending":{"default":"4.90","type":"string","enum":["90","95","99","4.90","00"]},"adjustmentBp":{"default":0,"type":"integer","minimum":-5000,"maximum":20000}},"required":["shopId","mode"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"number"}},"required":["markets"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/market-pricing/{marketId}":{"patch":{"operationId":"marketPricing.updateRule","summary":"Règle de prix d’un marché : `shopify` (conversion et arrondi de Shopify) ou `round` (prix ronds : palier supérieur de la terminaison, ajustement en points de base). Repasser en `shopify` retire les prix fixes de Shopymake. Lancer ensuite marketPricing.apply.","tags":["marketPricing"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"marketId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"marketId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Market\\/\\d+$"},"mode":{"type":"string","enum":["shopify","round"]},"ending":{"default":"4.90","type":"string","enum":["90","95","99","4.90","00"]},"adjustmentBp":{"default":0,"type":"integer","minimum":-5000,"maximum":20000}},"required":["shopId","marketId","mode"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mode":{"type":"string","enum":["shopify","round"]},"ending":{"type":"string","enum":["90","95","99","4.90","00"]},"adjustmentBp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"appliedAt":{"anyOf":[{},{"type":"null"}]}},"required":["mode","ending","adjustmentBp","appliedAt"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/market-pricing/apply":{"post":{"operationId":"marketPricing.apply","summary":"Recalcule au taux du jour et écrit dans Shopify les prix ronds de tous les produits, dans les marchés en prix ronds (tous, ou ceux donnés). Prix saisis à la main conservés. Renvoie l’identifiant du traitement à suivre avec jobs.get.","tags":["marketPricing"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"marketIds":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Market\\/\\d+$"}}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/market-pricing/{marketId}/override":{"post":{"operationId":"marketPricing.setOverride","summary":"Prix saisi à la main pour une variante dans un marché en prix ronds (centimes, devise du marché) : écrit dans Shopify et jamais recalculé. `price: null` revient au prix calculé.","tags":["marketPricing"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"marketId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"marketId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Market\\/\\d+$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"variantId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/ProductVariant\\/\\d+$"},"price":{"anyOf":[{"type":"integer","minimum":1,"maximum":100000000},{"type":"null"}]},"compareAt":{"default":null,"anyOf":[{"type":"integer","minimum":1,"maximum":100000000},{"type":"null"}]}},"required":["shopId","marketId","productId","variantId","price"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations":{"get":{"operationId":"translations.overview","summary":"État des traductions de la boutique par contenu (produits, collections, pages, menus, politiques, thème publié…) et par langue publiée : champs traduits, manquants et obsolètes.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["products","options","collections","pages","blog","menus","policies","shop","theme","filters"]},"label":{"type":"string"},"truncated":{"type":"boolean"},"stats":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"total":{"type":"number"},"translated":{"type":"number"},"outdated":{"type":"number"}},"required":["locale","total","translated","outdated"],"additionalProperties":false}}},"required":["id","label","truncated","stats"],"additionalProperties":false}}},"required":["locales","groups"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/stats/{group}":{"get":{"operationId":"translations.groupStats","summary":"État des traductions d’un groupe de contenus, par langue publiée.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"group","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"truncated":{"type":"boolean"},"stats":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"total":{"type":"number"},"translated":{"type":"number"},"outdated":{"type":"number"}},"required":["locale","total","translated","outdated"],"additionalProperties":false}}},"required":["truncated","stats"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/locales":{"get":{"operationId":"translations.locales","summary":"Langues publiées de la boutique autres que la principale (celles à traduire).","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/{locale}/{group}":{"get":{"operationId":"translations.list","summary":"Contenus d’un groupe à traduire dans une langue, 20 par page : texte d’origine, traduction et état de chaque champ.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}},{"name":"group","in":"path","required":true,"schema":{"type":"string"}},{"name":"filter","in":"query","required":false,"schema":{"default":"missing","type":"string","enum":["missing","outdated","all"]}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"pageSize":{"type":"number"},"resources":{"type":"array","items":{"type":"object","properties":{"resourceId":{"type":"string"},"title":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"source":{"type":"string"},"digest":{"type":"string"},"type":{"type":"string"},"translation":{"type":["string","null"]},"outdated":{"type":"boolean"}},"required":["key","source","digest","type","translation","outdated"],"additionalProperties":false}}},"required":["resourceId","title","fields"],"additionalProperties":false}}},"required":["total","pageSize","resources"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/{locale}/save":{"post":{"operationId":"translations.save","summary":"Enregistre les traductions d’un contenu dans une langue (valeur vide : traduction retirée). Le digest est celui du texte d’origine traduit.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"resourceId":{"type":"string","minLength":1,"maxLength":300},"values":{"minItems":1,"maxItems":300,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":300},"value":{"type":"string","maxLength":60000},"digest":{"type":"string","minLength":1,"maxLength":200}},"required":["key","value","digest"]}}},"required":["shopId","locale","resourceId","values"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"saved":{"type":"number"}},"required":["saved"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/{locale}/suggest":{"post":{"operationId":"translations.suggest","summary":"Propose par l’IA la traduction des champs d’un contenu (manquants, ou tous) sans l’enregistrer : à relire puis enregistrer avec translations.save.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"resourceId":{"type":"string","minLength":1,"maxLength":300},"all":{"default":false,"type":"boolean"}},"required":["shopId","locale","resourceId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"suggestions":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false}}},"required":["suggestions"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/translations/auto":{"post":{"operationId":"translations.autoTranslate","summary":"Traduit par l’IA les contenus de la boutique dans les langues publiées (par défaut toutes, tous les contenus) : champs manquants et obsolètes, ou tous (`overwrite`). Traitement long : renvoie l’identifiant à suivre avec jobs.get.","tags":["translations"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locales":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"}},"groups":{"minItems":1,"type":"array","items":{"type":"string","enum":["products","options","collections","pages","blog","menus","policies","shop","theme","filters"]}},"overwrite":{"default":false,"type":"boolean"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/locales":{"post":{"operationId":"locales.add","summary":"Ajoute une langue à la boutique (adresse principale : « /de », « /es »…) et la publie par défaut. Langue publiée et traduction automatique active : toute la boutique est traduite (traitement suivi).","tags":["locales"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"publish":{"default":true,"type":"boolean"}},"required":["shopId","locale"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"},"translationJobId":{"type":["string","null"]}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate","translationJobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/markets":{"post":{"operationId":"markets.create","summary":"Crée un marché dans Shopify : pays, devise, statut, et adresse (adresse principale de la boutique, ou sous-dossier « /fr-be » avec sa langue par défaut et ses autres langues).","tags":["markets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":100},"status":{"default":"ACTIVE","type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"currency":{"default":null,"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"localCurrencies":{"default":false,"type":"boolean"},"address":{"default":{"type":"primary"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"primary"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"subfolder"},"suffix":{"type":"string","pattern":"^[a-z0-9]{2,10}$"},"defaultLocale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"alternateLocales":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"}}},"required":["type","suffix","defaultLocale"]}]}},"required":["shopId","name","countries"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"},"marketId":{"type":"string"}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate","marketId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/markets/{marketId}":{"delete":{"operationId":"markets.delete","summary":"Supprime un marché dans Shopify (ses pays rejoignent les autres marchés ou ne sont plus servis) et son sous-dossier.","tags":["markets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"marketId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"patch":{"operationId":"markets.update","summary":"Modifie un marché dans Shopify : nom, statut, liste complète des pays, devise, devises locales, adresse et langues. Seuls les champs fournis changent.","tags":["markets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"marketId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"marketId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Market\\/\\d+$"},"name":{"type":"string","minLength":1,"maxLength":100},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"localCurrencies":{"type":"boolean"},"address":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"primary"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"subfolder"},"suffix":{"type":"string","pattern":"^[a-z0-9]{2,10}$"},"defaultLocale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"alternateLocales":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"}}},"required":["type","suffix","defaultLocale"]}]}},"required":["shopId","marketId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/localization":{"get":{"operationId":"localization.get","summary":"Marchés (pays, devise, adresse et langues), langues de la boutique (publiées ou non), langues disponibles et réglage de traduction automatique, lus en direct dans Shopify.","tags":["localization"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/locales/{locale}":{"delete":{"operationId":"locales.remove","summary":"Retire une langue de la boutique (pas la langue principale). Ses traductions sont supprimées par Shopify.","tags":["locales"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"patch":{"operationId":"locales.setPublished","summary":"Publie ou dépublie une langue de la boutique (visible ou non des clients). Publiée avec la traduction automatique : la boutique est traduite dans cette langue.","tags":["locales"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"},"published":{"type":"boolean"}},"required":["shopId","locale","published"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","DRAFT"]},"countries":{"type":"array","items":{"type":"string"}},"currency":{"type":["string","null"]},"localCurrencies":{"type":"boolean"},"webPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","handle","status","countries","currency","localCurrencies","webPresence"],"additionalProperties":false}},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"availableLocales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"}},"required":["locale","name"],"additionalProperties":false}},"primaryPresence":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"subfolderSuffix":{"type":["string","null"]},"domain":{"type":["string","null"]},"defaultLocale":{"type":"string"},"alternateLocales":{"type":"array","items":{"type":"string"}}},"required":["id","url","subfolderSuffix","domain","defaultLocale","alternateLocales"],"additionalProperties":false},{"type":"null"}]},"primaryHost":{"type":["string","null"]},"shopCurrency":{"type":"string"},"autoTranslate":{"type":"boolean"},"translationJobId":{"type":["string","null"]}},"required":["markets","locales","availableLocales","primaryPresence","primaryHost","shopCurrency","autoTranslate","translationJobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/localization/auto-translate":{"patch":{"operationId":"localization.setAutoTranslate","summary":"Active ou coupe la traduction automatique de la boutique : langue publiée, produits et collections créés, thème mis à jour, rattrapage quotidien des nouveaux contenus.","tags":["localization"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"type":"boolean"}},"required":["shopId","enabled"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"autoTranslate":{"type":"boolean"}},"required":["autoTranslate"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/localize-images":{"post":{"operationId":"productImages.localize","summary":"Refait les images du produit qui portent du texte dans chaque langue demandée (par défaut : les langues publiées autres que la principale) : textes traduits, image identique. Le thème Shopymake montre à chaque visiteur le carrousel de sa langue. Renvoie l’identifiant du traitement à suivre avec jobs.get.","tags":["productImages"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"locales":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$"}}},"required":["shopId","productId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/localized-images":{"get":{"operationId":"productImages.listLocalized","summary":"Images du produit langue par langue (ADR 0059) : pour chaque langue publiée et chaque position du carrousel, l’image d’origine et celle montrée aux visiteurs de cette langue (traduite ou d’origine).","tags":["productImages"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"images":{"type":"array","items":{"type":"object","properties":{"position":{"type":"number"},"original":{"type":"string"},"shown":{"type":"string"},"localized":{"type":"boolean"}},"required":["position","original","shown","localized"],"additionalProperties":false}}},"required":["locale","name","images"],"additionalProperties":false}}},"required":["locales"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}/logo/generate":{"post":{"operationId":"shops.generateLogo","summary":"Génère un logo pour la boutique, sans l’enregistrer : par défaut son nom en majuscules (Poppins Bold noir, fond transparent, sans marge) ; avec une consigne, un logo dessiné par le modèle d’image à partir de ce nom. Renvoie un PNG en base64, à enregistrer avec shops.setLogo.","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt":{"type":"string","maxLength":300}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mimeType":{"type":"string","const":"image/png"},"dataBase64":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"source":{"type":"string","enum":["default","ai"]}},"required":["mimeType","dataBase64","width","height","source"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}/logo":{"post":{"operationId":"shops.setLogo","summary":"Envoie le logo de la boutique dans Shopify (fichiers) et le rattache à la boutique (metafield shopymake.logo, lu par le thème Shopymake et le checkout). Image PNG, JPEG, WebP ou GIF, 3 Mo au plus, en base64.","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"filename":{"type":"string","minLength":1,"maxLength":120},"mimeType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"dataBase64":{"type":"string","minLength":1,"maxLength":4000008}},"required":["id","filename","mimeType","dataBase64"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"logoUrl":{"type":"string"}},"required":["logoUrl"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"delete":{"operationId":"shops.removeLogo","summary":"Retire le logo de la boutique (le fichier reste dans les fichiers Shopify).","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/me":{"get":{"operationId":"me.get","summary":"Retourne l'utilisateur authentifié (ou propriétaire de la clé API).","tags":["me"],"parameters":[],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["superadmin","user"]}},"required":["id","name","email","role"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/users":{"get":{"operationId":"users.list","summary":"Liste tous les utilisateurs (superadmin).","tags":["users"],"parameters":[],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["superadmin","user"]},"banned":{"type":["boolean","null"]},"createdAt":{}},"required":["id","name","email","role","banned","createdAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/users/{id}/disabled":{"post":{"operationId":"users.setDisabled","summary":"Désactive (ou réactive) un compte. Un compte désactivé est déconnecté immédiatement.","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","minLength":1},"disabled":{"type":"boolean"}},"required":["id","disabled"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"disabled":{"type":"boolean"}},"required":["id","disabled"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/audit-logs":{"get":{"operationId":"audit.list","summary":"Dernières entrées du journal d'audit (superadmin).","tags":["audit"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"actorType":{"type":"string"},"actorId":{"type":["string","null"]},"source":{"type":"string"},"action":{"type":"string"},"resourceType":{"type":["string","null"]},"resourceId":{"type":["string","null"]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"createdAt":{}},"required":["id","actorType","actorId","source","action","resourceType","resourceId","metadata","createdAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops":{"get":{"operationId":"shops.list","summary":"Liste les boutiques Shopify connectées avec leur nombre de produits et quelques images d’aperçu.","tags":["shops"],"parameters":[],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"primaryDomainUrl":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","error"]},"scopes":{"type":"array","items":{"type":"string"}},"lastSyncedAt":{"anyOf":[{},{"type":"null"}]},"lastSyncError":{"type":["string","null"]},"authMode":{"type":"string","enum":["client_credentials","authorization_code"]},"webhookUrl":{"type":["string","null"]},"brandGuidelines":{"type":["string","null"]},"discountMode":{"type":"string","enum":["automatic","code"]},"createdAt":{},"productsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"previewImages":{"type":"array","items":{"type":"string"}}},"required":["id","domain","name","currency","primaryDomainUrl","logoUrl","status","scopes","lastSyncedAt","lastSyncError","authMode","webhookUrl","brandGuidelines","discountMode","createdAt","productsCount","previewImages"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}":{"get":{"operationId":"shops.get","summary":"Détail d’une boutique : langues, marchés et nombre de produits.","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"primaryDomainUrl":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","error"]},"scopes":{"type":"array","items":{"type":"string"}},"lastSyncedAt":{"anyOf":[{},{"type":"null"}]},"lastSyncError":{"type":["string","null"]},"authMode":{"type":"string","enum":["client_credentials","authorization_code"]},"webhookUrl":{"type":["string","null"]},"brandGuidelines":{"type":["string","null"]},"discountMode":{"type":"string","enum":["automatic","code"]},"createdAt":{},"missingScopes":{"type":"array","items":{"type":"string"}},"productsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"locales":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"primary":{"type":"boolean"},"published":{"type":"boolean"}},"required":["locale","name","primary","published"],"additionalProperties":false}},"markets":{"type":"array","items":{"type":"object","properties":{"shopifyId":{"type":"string"},"name":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string"},"currency":{"type":["string","null"]},"countries":{"type":"array","items":{"type":"string"}}},"required":["shopifyId","name","handle","status","currency","countries"],"additionalProperties":false}}},"required":["id","domain","name","currency","primaryDomainUrl","logoUrl","status","scopes","lastSyncedAt","lastSyncError","authMode","webhookUrl","brandGuidelines","discountMode","createdAt","missingScopes","productsCount","locales","markets"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}/sync":{"post":{"operationId":"shops.sync","summary":"Resynchronise depuis Shopify les infos, langues, marchés et produits d’une boutique.","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"products":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"locales":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["products","locales","markets","warnings"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products":{"get":{"operationId":"products.list","summary":"Liste les produits synchronisés d’une boutique (recherche par titre ou handle).","tags":["products"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":250}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"shopifyId":{"type":"string"},"handle":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"vendor":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"priceMin":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"priceMax":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"currency":{"type":["string","null"]},"totalInventory":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"variantsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"templateSuffix":{"type":["string","null"]},"shopifyUpdatedAt":{}},"required":["id","shopifyId","handle","title","status","vendor","imageUrl","priceMin","priceMax","currency","totalInventory","variantsCount","templateSuffix","shopifyUpdatedAt"],"additionalProperties":false}}},"required":["total","items"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}/webhooks":{"post":{"operationId":"shops.registerWebhooks","summary":"Abonne la boutique aux notifications Shopify (produits, désinstallation, boutique).","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/webhook-events":{"get":{"operationId":"webhooks.list","summary":"Dernières notifications Shopify reçues pour une boutique.","tags":["webhooks"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"topic":{"type":"string"},"receivedAt":{},"error":{"type":["string","null"]}},"required":["id","topic","receivedAt","error"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers":{"get":{"operationId":"offers.list","summary":"Liste les offres (paliers, lots, cadeaux) d’une boutique, dans leur ordre d’évaluation.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"],"additionalProperties":false}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","gifts","freeShipping","display"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label","discount","maxQuantity","preChecked"],"additionalProperties":false}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}},"required":["enabled","preselected","tierDiscount"],"additionalProperties":false},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":["string","null"]},"id":{"type":"string"},"shopId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{},"updatedAt":{},"shadowed":{"anyOf":[{"type":"object","properties":{"productCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"by":{"type":"array","items":{"type":"string"}}},"required":["productCount","by"],"additionalProperties":false},{"type":"null"}]}},"required":["name","status","productIds","scope","excludedProductIds","mixAndMatch","tiers","rounding","addOns","display","subscription","templateId","id","shopId","position","createdAt","updatedAt","shadowed"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"offers.create","summary":"Crée le bundle d’un produit (un seul par produit, nommé comme lui) : paliers (quantités achetées/offertes, remise % ou prix de lot par devise), cadeaux, mix & match. L’arrondi des prix est celui de la boutique (bundles.updateBrandStyle) : `rounding` est ignoré.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"]},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"]}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"]},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"label":{"type":"string","maxLength":200}},"required":["options"]},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}}}},"required":["id","label","buyQuantity"]}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"label":{"type":"string","maxLength":200}},"required":["options"]},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label"]}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"]}}}},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type"]}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}}},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}}},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":"string","maxLength":100},"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["productIds","tiers","shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"],"additionalProperties":false}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","gifts","freeShipping","display"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label","discount","maxQuantity","preChecked"],"additionalProperties":false}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}},"required":["enabled","preselected","tierDiscount"],"additionalProperties":false},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":["string","null"]},"id":{"type":"string"},"shopId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{},"updatedAt":{},"publication":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["ok","error"],"additionalProperties":false}},"required":["name","status","productIds","scope","excludedProductIds","mixAndMatch","tiers","rounding","addOns","display","subscription","templateId","id","shopId","position","createdAt","updatedAt","publication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/offers/{id}":{"get":{"operationId":"offers.get","summary":"Détail d’une offre.","tags":["offers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"],"additionalProperties":false}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","gifts","freeShipping","display"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label","discount","maxQuantity","preChecked"],"additionalProperties":false}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}},"required":["enabled","preselected","tierDiscount"],"additionalProperties":false},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":["string","null"]},"id":{"type":"string"},"shopId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{},"updatedAt":{}},"required":["name","status","productIds","scope","excludedProductIds","mixAndMatch","tiers","rounding","addOns","display","subscription","templateId","id","shopId","position","createdAt","updatedAt"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"patch":{"operationId":"offers.update","summary":"Remplace les champs d’une offre (mêmes règles que la création ; `rounding` ignoré, arrondi de la boutique).","tags":["offers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"]},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"]}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"]},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"label":{"type":"string","maxLength":200}},"required":["options"]},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}}}},"required":["id","label","buyQuantity"]}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId"]}},"label":{"type":"string","maxLength":200}},"required":["options"]},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label"]}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"]}}}},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type"]}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}}},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}}},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":"string","maxLength":100},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["productIds","tiers","id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"status":{"default":"draft","type":"string","enum":["active","draft"]},"productIds":{"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"scope":{"default":{"type":"products"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"products"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"collections"},"collectionIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["type","collectionIds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"all"}},"required":["type"],"additionalProperties":false}]},"excludedProductIds":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","gifts","freeShipping","display"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"addOns":{"default":[],"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"productId":{"type":"string","minLength":1,"maxLength":100},"variantId":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false}]},"maxQuantity":{"default":1,"type":"integer","minimum":1,"maximum":10},"preChecked":{"default":false,"type":"boolean"}},"required":["id","productId","variantId","label","discount","maxQuantity","preChecked"],"additionalProperties":false}},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false},"subscription":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"preselected":{"default":false,"type":"boolean"},"tierDiscount":{"default":"first_order","type":"string","enum":["first_order","every_order"]}},"required":["enabled","preselected","tierDiscount"],"additionalProperties":false},{"type":"null"}]},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"templateId":{"type":["string","null"]},"id":{"type":"string"},"shopId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{},"updatedAt":{},"publication":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["ok","error"],"additionalProperties":false}},"required":["name","status","productIds","scope","excludedProductIds","mixAndMatch","tiers","rounding","addOns","display","subscription","templateId","id","shopId","position","createdAt","updatedAt","publication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"delete":{"operationId":"offers.delete","summary":"Supprime une offre ; la vitrine et les remises Shopify sont republiées.","tags":["offers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deleted":{"type":"boolean"},"publication":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["ok","error"],"additionalProperties":false}},"required":["deleted","publication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/bundles/style":{"get":{"operationId":"bundles.brandStyle","summary":"Style de marque des bundles d’une boutique (jetons enregistrés et style complet).","tags":["bundles"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"rounding":{"type":"string","enum":["90","99","none","00"]},"resolved":{"type":"object","properties":{"layout":{"type":"string"},"columns":{"type":"number"},"radius":{"type":"number"},"spacing":{"type":"number"},"colors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"fonts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"size":{"type":"number"},"weight":{"type":"string"}},"required":["size","weight"],"additionalProperties":false}}},"required":["layout","columns","colors","fonts"],"additionalProperties":false}},"required":["style","rounding","resolved"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"patch":{"operationId":"bundles.updateBrandStyle","summary":"Remplace le style de marque des bundles d’une boutique (disposition, couleurs #RRGGBB, typographie, arrondi, espacement) et, si fourni, l’arrondi des prix calculés de tous ses bundles ; le publie sur la boutique.","tags":["bundles"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"]}}}},"rounding":{"type":"string","enum":["90","99","none","00"]}},"required":["shopId","style"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"rounding":{"type":"string","enum":["90","99","none","00"]},"resolved":{"type":"object","properties":{"layout":{"type":"string"},"columns":{"type":"number"},"radius":{"type":"number"},"spacing":{"type":"number"},"colors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"fonts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"size":{"type":"number"},"weight":{"type":"string"}},"required":["size","weight"],"additionalProperties":false}}},"required":["layout","columns","colors","fonts"],"additionalProperties":false},"published":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["style","rounding","resolved","published","error"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/collections":{"get":{"operationId":"collections.list","summary":"Collections synchronisées d’une boutique (titre, handle, nombre de produits) : portée des bundles par collection.","tags":["collections"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"handle":{"type":"string"},"productsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","title","handle","productsCount"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/for-product":{"get":{"operationId":"offers.forProduct","summary":"Bundle d’un produit (un seul par produit), ou null s’il n’en a pas.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["active","draft"]},"scope":{"type":"string","enum":["products","collections","all"]}},"required":["id","name","status","scope"],"additionalProperties":false},{"type":"null"}]}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/discount-mode":{"post":{"operationId":"offers.setDiscountMode","summary":"Mode des remises Shopify des bundles (ADR 0038) : automatiques (25 actives au plus par boutique) ou codes promo appliqués au panier par la vitrine (thème Shopymake 1.21+ ou kit réinstallé requis). Les remises sont aussitôt remplacées dans Shopify.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["automatic","code"]}},"required":["shopId","mode"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mode":{"type":"string","enum":["automatic","code"]},"publication":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["ok","error"],"additionalProperties":false}},"required":["mode","publication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/offers/{id}/translate":{"post":{"operationId":"offers.translate","summary":"Traduit les textes d’un bundle (paliers, badges, pastilles, titre, champs, produits en option) dans les langues publiées de la boutique (ou celles données), puis le republie : chaque visiteur le voit dans sa langue.","tags":["offers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"locales":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"}}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"locales":{"type":"array","items":{"type":"string"}},"texts":{"type":"number"},"publication":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["ok","error"],"additionalProperties":false}},"required":["locales","texts","publication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/publish":{"post":{"operationId":"offers.publish","summary":"Publie les offres actives sur les produits Shopify (metafield shopymake.offers) et retire celles qui ne s’appliquent plus.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"published":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"removed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"discounts":{"anyOf":[{"type":"object","properties":{"created":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deleted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unchanged":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"reports":{"type":"array","items":{"type":"object","properties":{"offerId":{"type":["string","null"]},"name":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning"]},"message":{"type":"string"},"tierId":{"type":"string"}},"required":["level","message"],"additionalProperties":false}}},"required":["offerId","name","issues"],"additionalProperties":false}},"errors":{"type":"array","items":{"type":"string"}}},"required":["created","updated","deleted","unchanged","reports","errors"],"additionalProperties":false},{"type":"null"}]},"discountsError":{"type":["string","null"]}},"required":["published","removed","discounts","discountsError"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/check-pricing":{"post":{"operationId":"offers.checkPricing","summary":"Contrôle les prix des offres actives : Shopify chiffre chaque palier (quantité du lot, cadeaux compris) avec ses remises automatiques, comparé au prix affiché sur la fiche. Ne crée rien.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"offerId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"offerId":{"type":"string"},"name":{"type":"string"},"product":{"type":["string","null"]},"error":{"type":["string","null"]},"tiers":{"type":"array","items":{"type":"object","properties":{"tierId":{"type":"string"},"label":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"displayed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"charged":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"giftsCharged":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ok":{"type":"boolean"}},"required":["tierId","label","quantity","displayed","charged","giftsCharged","ok"],"additionalProperties":false}}},"required":["offerId","name","product","error","tiers"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/offers/{id}/shopify-issues":{"get":{"operationId":"offers.shopifyIssues","summary":"Ce que Shopify ne peut pas appliquer exactement dans son panier pour une offre (traduction en remises automatiques), sans rien modifier.","tags":["offers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"live":{"type":"boolean"},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning"]},"message":{"type":"string"},"tierId":{"type":"string"}},"required":["level","message"],"additionalProperties":false}}},"required":["live","issues"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/simulate":{"post":{"operationId":"offers.simulate","summary":"Simule le prix d’un panier avec les offres actives d’une boutique (prix unitaires fournis).","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"lines":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"quantity":{"type":"integer","minimum":1,"maximum":999},"unitPrice":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["variantId","productId","quantity","unitPrice"]}},"giftSelections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["shopId","currency","lines"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"subtotal":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"discount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"freeShipping":{"type":"boolean"},"lines":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"subtotal":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"discount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"freeUnits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offerId":{"type":["string","null"]},"tierId":{"type":["string","null"]}},"required":["variantId","quantity","subtotal","discount","total","freeUnits","offerId","tierId"],"additionalProperties":false}},"gifts":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["variantId","quantity"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["subtotal","discount","total","freeShipping","lines","gifts","warnings"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews":{"get":{"operationId":"reviews.list","summary":"Liste les avis d’une boutique (filtres : produit, note, recherche texte).","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"query","required":false,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},{"name":"rating","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"average":{"type":["number","null"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["manual","trustpilot","csv"]},"author":{"type":"string"},"country":{"type":["string","null"]},"rating":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":["string","null"]},"body":{"type":"string"},"photos":{"type":"array","items":{"type":"string"}},"reviewedAt":{},"verified":{"type":"boolean"},"published":{"type":"boolean"},"productIds":{"type":"array","items":{"type":"string"}}},"required":["id","source","author","country","rating","title","body","photos","reviewedAt","verified","published","productIds"],"additionalProperties":false}}},"required":["total","average","items"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"reviews.create","summary":"Ajoute un avis saisi à la main et le rattache à des produits.","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"author":{"type":"string","minLength":1,"maxLength":120},"country":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"rating":{"type":"integer","minimum":1,"maximum":5},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"body":{"type":"string","minLength":1,"maxLength":5000},"photos":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","maxLength":1000,"format":"uri"}},"reviewedAt":{},"verified":{"default":false,"type":"boolean"},"published":{"default":true,"type":"boolean"},"productIds":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}}},"required":["shopId","author","rating","body"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews/{id}":{"patch":{"operationId":"reviews.update","summary":"Modifie un avis : seuls les champs fournis changent. Avec productIds, remplace ses produits.","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"author":{"type":"string","minLength":1,"maxLength":120},"country":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"rating":{"type":"integer","minimum":1,"maximum":5},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"body":{"type":"string","minLength":1,"maxLength":5000},"photos":{"maxItems":4,"type":"array","items":{"type":"string","maxLength":1000,"format":"uri"}},"reviewedAt":{},"verified":{"type":"boolean"},"published":{"type":"boolean"},"productIds":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}}},"required":["shopId","id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews/delete":{"post":{"operationId":"reviews.delete","summary":"Supprime des avis.","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ids":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["shopId","ids"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deleted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews/assign":{"post":{"operationId":"reviews.assign","summary":"Ajoute, retire ou remplace les produits d’un ensemble d’avis (un avis peut concerner plusieurs produits).","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reviewIds":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"productIds":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"mode":{"default":"add","type":"string","enum":["add","remove","replace"]}},"required":["shopId","reviewIds","productIds"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["updated"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews/import":{"post":{"operationId":"reviews.import","summary":"Importe des avis depuis un CSV (export Trustpilot ou colonnes auteur/note/avis/date). Les doublons sont ignorés.","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"csv":{"type":"string","minLength":1,"maxLength":5000000},"source":{"default":"trustpilot","type":"string","enum":["trustpilot","csv"]},"productIds":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"verified":{"default":true,"type":"boolean"}},"required":["shopId","csv"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"imported":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duplicates":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"errors":{"type":"array","items":{"type":"object","properties":{"line":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"message":{"type":"string"}},"required":["line","message"],"additionalProperties":false}}},"required":["imported","duplicates","errors"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/reviews/publish":{"post":{"operationId":"reviews.publish","summary":"Publie sur chaque produit sa note moyenne, sa répartition et ses derniers avis (metafield shopymake.reviews).","tags":["reviews"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"published":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"removed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["published","removed"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes":{"get":{"operationId":"theme.list","summary":"Thèmes de la boutique (MAIN = publié, jamais modifié par l’outil).","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"processing":{"type":"boolean"},"updatedAt":{"type":"string"}},"required":["id","name","role","processing","updatedAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/working-copy":{"post":{"operationId":"theme.createWorkingCopy","summary":"Duplique le thème publié en copie de travail non publiée, où l’outil peut écrire.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":50}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}},"required":["id","name","role"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/install-kit":{"post":{"operationId":"theme.installKit","summary":"Installe ou met à jour les fichiers sm-* (offres, note, avis) dans un thème non publié. Le reste du thème n’est pas touché.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},"required":["shopId","themeId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"files":{"type":"array","items":{"type":"string"}}},"required":["files"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/enable-kit":{"post":{"operationId":"theme.enableKitOnTemplate","summary":"Ajoute la note, les offres et/ou la section d’avis Shopymake à un template produit d’un thème non publié.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"template":{"type":"string","pattern":"^product(\\.[a-z0-9_-]+)?$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"rating":{"default":true,"type":"boolean"},"offers":{"default":true,"type":"boolean"},"reviews":{"default":true,"type":"boolean"}},"required":["shopId","themeId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"filename":{"type":"string"},"added":{"type":"array","items":{"type":"string"}}},"required":["filename","added"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/preview":{"get":{"operationId":"theme.previewUrl","summary":"Lien d’aperçu sur un thème non publié : un produit (handle), une collection, une page, ou l’accueil.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},{"name":"resource","in":"query","required":false,"schema":{"default":"product","type":"string"}},{"name":"handle","in":"query","required":false,"schema":{"type":"string","maxLength":255}},{"name":"view","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme":{"get":{"operationId":"shopymakeTheme.status","summary":"Thèmes de la boutique avec la version du thème Shopymake installée sur chacun, et la dernière version disponible.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"latestVersion":{"type":"string"},"themes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"processing":{"type":"boolean"},"updatedAt":{"type":"string"},"shopymakeVersion":{"type":["string","null"]}},"required":["id","name","role","processing","updatedAt","shopymakeVersion"],"additionalProperties":false}}},"required":["latestVersion","themes"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/install":{"post":{"operationId":"shopymakeTheme.install","summary":"Installe le thème Shopymake dans un nouveau thème non publié (copie du thème publié dont tous les fichiers sont remplacés). Le thème publié n’est pas modifié. Renvoie l’identifiant du traitement à suivre avec jobs.get.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":50}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/update":{"post":{"operationId":"shopymakeTheme.update","summary":"Met à jour un thème Shopymake non publié vers la dernière version : réglages de design, templates et groupes de sections du marchand conservés.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},"required":["shopId","themeId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string"},"written":{"type":"number"},"deleted":{"type":"number"},"pages":{"type":"number"}},"required":["version","written","deleted","pages"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/update-live":{"post":{"operationId":"shopymakeTheme.updateLive","summary":"Met à jour le thème Shopymake en ligne : copie du thème publié, mise à jour de la copie (design et pages conservés), publication ; l’ancien thème reste en sauvegarde. Renvoie l’identifiant du traitement.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/design":{"get":{"operationId":"shopymakeTheme.design","summary":"Jetons de design (couleurs, polices, arrondis, espacements, panier, réseaux sociaux) d’un thème Shopymake, avec leur définition.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"themeId":{"type":"string"},"role":{"type":"string"},"settings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"group":{"type":"string"},"section":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"info":{"type":"string"},"default":{"type":["string","number","boolean"]},"min":{"type":"number"},"max":{"type":"number"},"step":{"type":"number"},"unit":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"],"additionalProperties":false}},"en":{"type":"object","properties":{"group":{"type":"string"},"section":{"type":"string"},"label":{"type":"string"},"info":{"type":"string"},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["group","label"],"additionalProperties":false}},"required":["id","group","type","label"],"additionalProperties":false}},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean"]}},"lastPublication":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"at":{},"keys":{"type":"array","items":{"type":"string"}}},"required":["id","at","keys"],"additionalProperties":false},{"type":"null"}]}},"required":["themeId","role","settings","values","lastPublication"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"shopymakeTheme.updateDesign","summary":"Modifie des jetons de design d’un thème Shopymake non publié (les autres réglages sont conservés). Publier le thème pour appliquer.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean"]}}},"required":["shopId","themeId","values"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"array","items":{"type":"string"}}},"required":["updated"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/live-design/preview":{"post":{"operationId":"shopymakeTheme.previewLiveDesign","summary":"Aperçu du style du thème en ligne avec des réglages modifiés, sans les publier : écrits dans une copie cachée du thème en ligne. Renvoie le lien d’aperçu de la boutique.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean"]}}},"required":["shopId","values"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"},"themeId":{"type":"string"}},"required":["url","themeId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/live-design":{"post":{"operationId":"shopymakeTheme.publishLiveDesign","summary":"Publie des réglages de style directement sur le thème en ligne (seul config/settings_data.json est modifié, ADR 0042). Les valeurs d’avant sont gardées pour annuler avec shopymakeTheme.revertLiveDesign.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean"]}}},"required":["shopId","values"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"array","items":{"type":"string"}},"publicationId":{"type":"string"}},"required":["updated","publicationId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/live-design/revert":{"post":{"operationId":"shopymakeTheme.revertLiveDesign","summary":"Annule la dernière publication du style sur le thème en ligne : les réglages d’avant sont remis.","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reverted":{"type":"array","items":{"type":"string"}}},"required":["reverted"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/shopymake-theme/publish":{"post":{"operationId":"shopymakeTheme.publish","summary":"Publie un thème Shopymake non publié : il devient le thème de la boutique en ligne (l’ancien reste disponible, non publié).","tags":["shopymakeTheme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},"required":["shopId","themeId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}},"required":["id","name","role"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/theme-schemas":{"get":{"operationId":"theme.schemas","summary":"Schémas des sections et blocs d’un thème (réglages, blocs autorisés, presets), pour générer les formulaires.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},{"name":"refresh","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sections":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"filename":{"type":"string"},"schema":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["type","filename","schema"],"additionalProperties":false}},"blocks":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"filename":{"type":"string"},"schema":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["type","filename","schema"],"additionalProperties":false}}},"required":["sections","blocks"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/templates":{"get":{"operationId":"theme.templates","summary":"Templates JSON d’un thème (produit, collection, page, accueil…), avec leur suffixe.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"filename":{"type":"string"},"resource":{"type":"string"},"suffix":{"type":["string","null"]}},"required":["filename","resource","suffix"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/template":{"get":{"operationId":"theme.getTemplate","summary":"Contenu d’un template JSON : sections, blocs, réglages et ordre.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}},{"name":"filename","in":"query","required":true,"schema":{"type":"string","pattern":"^templates\\/[a-z_]+(\\.[a-z0-9_-]+)?\\.json$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"filename":{"type":"string"},"template":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["filename","template"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"theme.saveTemplate","summary":"Enregistre un template JSON dans un thème non publié. Les types de sections doivent exister dans le thème.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"filename":{"type":"string","pattern":"^templates\\/[a-z_]+(\\.[a-z0-9_-]+)?\\.json$"},"template":{"type":"object","properties":{"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"order":{"type":"array","items":{"type":"string"}}},"required":["sections","order"],"additionalProperties":{}}},"required":["shopId","themeId","filename","template"],"$defs":{"__schema0":{"type":"object","properties":{"type":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"disabled":{"type":"boolean"},"static":{"type":"boolean"},"blocks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"block_order":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":{}}}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"filename":{"type":"string"}},"required":["filename"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/editor":{"get":{"operationId":"productEditor.get","summary":"Produit (nom, statut, options, variantes et prix en centimes) et sa page : template du thème Shopymake, ou page à créer depuis l’ancien contenu ou le template par défaut.","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"withPage","in":"query","required":false,"schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"handle":{"type":"string"},"hasOwnPage":{"type":"boolean"},"status":{"type":"string","enum":["ACTIVE","DRAFT","ARCHIVED"]},"currency":{"type":"string"},"url":{"type":["string","null"]},"previewUrl":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["id","name","values"],"additionalProperties":false}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"compareAtPrice":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"sku":{"type":["string","null"]},"mediaId":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}}},"required":["id","title","price","compareAtPrice","sku","mediaId","options"],"additionalProperties":false}},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"additionalProperties":false}},"localizedImages":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"name":{"type":"string"},"translated":{"type":"number"}},"required":["locale","name","translated"],"additionalProperties":false}},"marketPrices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"mode":{"type":"string","enum":["shopify","round"]},"prices":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"price":{"type":["number","null"]},"compareAt":{"type":["number","null"]},"locked":{"type":"boolean"}},"required":["variantId","price","compareAt","locked"],"additionalProperties":false}}},"required":["id","name","currency","mode","prices"],"additionalProperties":false}}},"required":["id","title","handle","hasOwnPage","status","currency","url","previewUrl","options","variants","media","localizedImages","marketPrices"],"additionalProperties":false},"page":{"anyOf":[{"type":"object","properties":{"themeId":{"type":"string"},"themeName":{"type":"string"},"published":{"type":"boolean"},"suffix":{"type":"string"},"source":{"type":"string","enum":["template","copy","legacy","default"]},"copiedFrom":{"type":["string","null"]},"notice":{"type":["string","null"]},"template":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["themeId","themeName","published","suffix","source","copiedFrom","notice","template"],"additionalProperties":false},{"type":"null"}]},"pageUnavailable":{"type":["string","null"]}},"required":["product","page","pageUnavailable"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/page":{"get":{"operationId":"productEditor.page","summary":"Page d’un produit dans le thème Shopymake : template à modifier (le sien, celui qu’il utilise, l’ancien contenu ou le template par défaut), ou raison de son absence.","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"anyOf":[{"type":"object","properties":{"themeId":{"type":"string"},"themeName":{"type":"string"},"published":{"type":"boolean"},"suffix":{"type":"string"},"source":{"type":"string","enum":["template","copy","legacy","default"]},"copiedFrom":{"type":["string","null"]},"notice":{"type":["string","null"]},"template":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["themeId","themeName","published","suffix","source","copiedFrom","notice","template"],"additionalProperties":false},{"type":"null"}]},"pageUnavailable":{"type":["string","null"]}},"required":["page","pageUnavailable"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"productEditor.savePage","summary":"Enregistre la page d’un produit (template du thème Shopymake) dans le thème publié et les copies à jour, et la rattache au produit. L’ancien contenu de page est retiré.","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"template":{"type":"object","properties":{"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"order":{"type":"array","items":{"type":"string"}}},"required":["sections","order"],"additionalProperties":{}}},"required":["shopId","productId","template"],"$defs":{"__schema0":{"type":"object","properties":{"type":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"disabled":{"type":"boolean"},"static":{"type":"boolean"},"blocks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"block_order":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":{}}}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"suffix":{"type":"string"},"themes":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["suffix","themes","warnings"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/page/preview":{"post":{"operationId":"productEditor.previewPage","summary":"Écrit la page en cours d’édition dans un template d’aperçu (invisible des clients) et renvoie l’adresse où Shopify l’affiche.","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"template":{"type":"object","properties":{"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"order":{"type":"array","items":{"type":"string"}}},"required":["sections","order"],"additionalProperties":{}}},"required":["shopId","productId","template"],"$defs":{"__schema0":{"type":"object","properties":{"type":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"disabled":{"type":"boolean"},"static":{"type":"boolean"},"blocks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"block_order":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":{}}}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":["string","null"]}},"required":["url"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/page/translate":{"post":{"operationId":"productEditor.translatePage","summary":"Traduit les textes de la page d’un produit dans les autres langues publiées de la boutique (traductions Shopify du thème publié, recopiées sur les autres thèmes Shopymake).","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"required":["shopId","productId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"locales":{"type":"array","items":{"type":"string"}},"failed":{"type":"array","items":{"type":"string"}}},"required":["locales","failed"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}":{"patch":{"operationId":"productEditor.updateProduct","summary":"Modifie un produit : nom, statut, options (renommer, ajouter ou supprimer des valeurs et des options : les variantes suivent), prix (centimes), prix barré, SKU et image des variantes. Seuls les champs fournis changent. Une nouvelle variante reprend le prix de la plus proche.","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"title":{"type":"string","minLength":1,"maxLength":255},"status":{"type":"string","enum":["ACTIVE","DRAFT","ARCHIVED"]},"options":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":255},"values":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":255}},"required":["id","name"]}},"valuesToAdd":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":255}},"valuesToDelete":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1}}},"required":["id"]}},"newOptions":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"values":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"required":["name","values"]}},"deleteOptions":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"variants":{"maxItems":250,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"price":{"type":"integer","minimum":0,"maximum":100000000},"compareAtPrice":{"anyOf":[{"type":"integer","minimum":0,"maximum":100000000},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"mediaId":{"type":"string","minLength":1}},"required":["id"]}}},"required":["shopId","productId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","warnings"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/{productId}/images":{"post":{"operationId":"productEditor.addImage","summary":"Ajoute une image à la fin du carrousel d’un produit (PNG, JPEG, WebP ou GIF, 3 Mo au plus, en base64) et l’attribue aux variantes indiquées (ex. toutes celles d’une couleur).","tags":["productEditor"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"filename":{"type":"string","minLength":1,"maxLength":120},"mimeType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"dataBase64":{"type":"string","minLength":1,"maxLength":4000008},"alt":{"type":"string","maxLength":255},"variantIds":{"default":[],"maxItems":250,"type":"array","items":{"type":"string","minLength":1}}},"required":["shopId","productId","filename","mimeType","dataBase64"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mediaId":{"type":"string"},"url":{"type":"string"}},"required":["mediaId","url"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/templates/duplicate":{"post":{"operationId":"theme.duplicateTemplate","summary":"Duplique un template sous un nouveau suffixe (ex. product.json → product.lampe-solaire.json), dans un thème non publié.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"from":{"type":"string","pattern":"^templates\\/[a-z_]+(\\.[a-z0-9_-]+)?\\.json$"},"suffix":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"}},"required":["shopId","themeId","from","suffix"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"filename":{"type":"string"}},"required":["filename"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/template":{"post":{"operationId":"products.setTemplate","summary":"Choisit le template d’un produit (suffixe, ou null pour le template par défaut). Effet immédiat sur la boutique : le template doit exister dans le thème publié.","tags":["products"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"suffix":{"anyOf":[{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"},{"type":"null"}]}},"required":["shopId","productId","suffix"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"templateSuffix":{"type":["string","null"]}},"required":["templateSuffix"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/presets":{"get":{"operationId":"presets.list","summary":"Modèles de sections réutilisables d’une boutique.","tags":["presets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"sectionType":{"type":"string"},"section":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{}},"required":["id","name","sectionType","section","createdAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"presets.save","summary":"Enregistre une section configurée (réglages et blocs) comme modèle réutilisable.","tags":["presets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":120},"section":{"$ref":"#/$defs/__schema0"}},"required":["shopId","name","section"],"$defs":{"__schema0":{"type":"object","properties":{"type":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"disabled":{"type":"boolean"},"static":{"type":"boolean"},"blocks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}},"block_order":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":{}}}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/presets/{id}":{"delete":{"operationId":"presets.delete","summary":"Supprime un modèle de section.","tags":["presets"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/page-models":{"get":{"operationId":"pageModels.list","summary":"Modèles de pages produit d’une boutique (les plus récents d’abord).","tags":["pageModels"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"sourceTitle":{"type":["string","null"]},"sections":{"type":"number"},"createdAt":{}},"required":["id","name","sourceTitle","sections","createdAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"pageModels.saveFromProduct","summary":"Enregistre la page d’un produit (son template du thème Shopymake, tel qu’enregistré) comme modèle de page réutilisable par Smart Page AI.","tags":["pageModels"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"name":{"type":"string","minLength":1,"maxLength":120}},"required":["shopId","productId","name"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/page-models/{id}":{"delete":{"operationId":"pageModels.delete","summary":"Supprime un modèle de page (les pages déjà créées avec lui ne changent pas).","tags":["pageModels"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/pipeline/duplicate":{"post":{"operationId":"pipeline.duplicateProduct","summary":"Duplique une fiche produit concurrente à partir de son URL : lecture (textes et images), rédaction IA selon la charte de marque, images refaites avec la marque de la boutique, variantes, prix selon la règle choisie, traductions, création dans Shopify. Renvoie l’identifiant du traitement à suivre avec jobs.get.","tags":["pipeline"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string","maxLength":2000,"format":"uri"},"pricing":{"default":{"type":"match"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"match"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent_off"},"value":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":10}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed"},"price":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["type","price"]}]},"priceEnding":{"default":"none","type":"string","enum":["90","95","99","none"]},"imageMode":{"default":"ai","type":"string","enum":["ai","original","none"]},"imageStyle":{"default":"remake","type":"string","enum":["remake","reshoot"]},"maxImages":{"type":"integer","minimum":0,"maximum":20},"notes":{"type":"string","maxLength":2000},"status":{"default":"DRAFT","type":"string","enum":["DRAFT","ACTIVE"]},"offer":{"default":"competitor","anyOf":[{"type":"string","enum":["competitor","auto","none"]},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}]},"templateSuffix":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"},"pageTemplate":{"default":true,"type":"boolean"},"pageModelId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"string","const":"theme"}]},"sampleReviews":{"default":false,"type":"boolean"},"keepBranding":{"default":false,"type":"boolean"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"baseTemplate":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"}},"required":["shopId","url"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/pipeline/regenerate":{"post":{"operationId":"pipeline.regenerateProduct","summary":"Refait la fiche d’un produit déjà dupliqué à partir de la page concurrente : textes, contenu de la page et/ou images (refaites à l’identique avec la marque de la boutique). Variantes, prix, handle et offres sont conservés. Renvoie l’identifiant du traitement à suivre avec jobs.get.","tags":["pipeline"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"},"url":{"type":"string","maxLength":2000,"format":"uri"},"copy":{"default":true,"type":"boolean"},"images":{"default":true,"type":"boolean"},"imageMode":{"type":"string","enum":["ai","original","none"]},"imageStyle":{"type":"string","enum":["remake","reshoot"]},"maxImages":{"type":"integer","minimum":0,"maximum":20},"notes":{"type":"string","maxLength":2000}},"required":["shopId","productId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/pipeline/duplicate-batch":{"post":{"operationId":"pipeline.duplicateBatch","summary":"Duplique plusieurs pages concurrentes (10 au plus) avec les mêmes réglages : un traitement par page, lancés ensemble. Renvoie les identifiants des traitements.","tags":["pipeline"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"pricing":{"default":{"type":"match"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"match"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent_off"},"value":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":10}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed"},"price":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["type","price"]}]},"priceEnding":{"default":"none","type":"string","enum":["90","95","99","none"]},"imageMode":{"default":"ai","type":"string","enum":["ai","original","none"]},"imageStyle":{"default":"remake","type":"string","enum":["remake","reshoot"]},"maxImages":{"type":"integer","minimum":0,"maximum":20},"notes":{"type":"string","maxLength":2000},"status":{"default":"DRAFT","type":"string","enum":["DRAFT","ACTIVE"]},"offer":{"default":"competitor","anyOf":[{"type":"string","enum":["competitor","auto","none"]},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}]},"templateSuffix":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"},"pageTemplate":{"default":true,"type":"boolean"},"pageModelId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"string","const":"theme"}]},"sampleReviews":{"default":false,"type":"boolean"},"keepBranding":{"default":false,"type":"boolean"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"baseTemplate":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,60}$"},"urls":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}}},"required":["shopId","urls"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobIds":{"type":"array","items":{"type":"string"}}},"required":["jobIds"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/pipeline/history":{"get":{"operationId":"pipeline.history","summary":"Historique des duplications d’une boutique, groupé par produit : dernière version en tête, puis les précédentes (duplication et régénérations).","tags":["pipeline"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":30,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"productId":{"type":["string","null"]},"title":{"type":"string"},"sourceUrl":{"type":["string","null"]},"latest":{"type":"object","properties":{"jobId":{"type":"string"},"kind":{"type":"string","enum":["duplicate","regenerate"]},"status":{"type":"string","enum":["queued","running","succeeded","failed"]},"title":{"type":["string","null"]},"createdAt":{}},"required":["jobId","kind","status","title","createdAt"],"additionalProperties":false},"versions":{"type":"array","items":{"type":"object","properties":{"jobId":{"type":"string"},"kind":{"type":"string","enum":["duplicate","regenerate"]},"status":{"type":"string","enum":["queued","running","succeeded","failed"]},"title":{"type":["string","null"]},"createdAt":{}},"required":["jobId","kind","status","title","createdAt"],"additionalProperties":false}}},"required":["key","productId","title","sourceUrl","latest","versions"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/jobs/{id}":{"get":{"operationId":"jobs.get","summary":"État d’un traitement long (étapes, résultat ou erreur).","tags":["jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"shopId":{"type":["string","null"]},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"steps":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["pending","running","done","skipped","failed"]},"detail":{"type":"string"},"at":{"type":"string"}},"required":["key","label","status"],"additionalProperties":false}},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"error":{"type":["string","null"]},"createdAt":{},"startedAt":{"anyOf":[{},{"type":"null"}]},"finishedAt":{"anyOf":[{},{"type":"null"}]}},"required":["id","shopId","type","status","input","steps","result","error","createdAt","startedAt","finishedAt"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/jobs":{"get":{"operationId":"jobs.list","summary":"Derniers traitements d’une boutique.","tags":["jobs"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":60}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"shopId":{"type":["string","null"]},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"steps":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["pending","running","done","skipped","failed"]},"detail":{"type":"string"},"at":{"type":"string"}},"required":["key","label","status"],"additionalProperties":false}},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"error":{"type":["string","null"]},"createdAt":{},"startedAt":{"anyOf":[{},{"type":"null"}]},"finishedAt":{"anyOf":[{},{"type":"null"}]}},"required":["id","shopId","type","status","input","steps","result","error","createdAt","startedAt","finishedAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{id}/brand":{"patch":{"operationId":"shops.updateBrand","summary":"Charte de marque de la boutique (ton, cible, mots à éviter), suivie par l’IA pour tous les textes.","tags":["shops"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandGuidelines":{"type":"string","maxLength":5000}},"required":["id","brandGuidelines"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/settings":{"get":{"operationId":"checkout.settings","summary":"Réglages du checkout externe d’une boutique (sans les clés secrètes) et adresse du webhook Stripe.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"enabled":{"type":"boolean"},"stripeAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"publishableKey":{"type":"string"},"mode":{"type":"string","enum":["test","live"]},"isDefault":{"type":"boolean"},"marketIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","publishableKey","mode","isDefault","marketIds"],"additionalProperties":false}},"shippingRates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"countries":{"type":"array","items":{"type":"string"}},"webhookUrl":{"type":["string","null"]},"shippingSource":{"type":"string","enum":["shopify","manual"]},"shopifyShipping":{"anyOf":[{"type":"object","properties":{"model":{"type":"string","enum":["profiles","markets"]},"syncedAt":{"anyOf":[{},{"type":"null"}]},"countries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"zones":{"type":"array","items":{"type":"object","properties":{"profile":{"type":["string","null"]},"name":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"restOfWorld":{"type":"boolean"},"methods":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"currency":{"type":"string"},"basis":{"type":"string","enum":["flat","value","weight"]},"tiers":{"type":"array","items":{"type":"object","properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"price":{"type":"number"}},"required":["min","max","price"],"additionalProperties":false}},"freeAbove":{"type":["number","null"]},"byCollection":{"type":"boolean"}},"required":["name","currency","basis","tiers","freeAbove","byCollection"],"additionalProperties":false}}},"required":["profile","name","countries","restOfWorld","methods"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["model","syncedAt","countries","zones","warnings"],"additionalProperties":false},{"type":"null"}]},"shippingSyncError":{"type":["string","null"]},"appearance":{"type":"object","properties":{"logoUrl":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"logoSize":{"default":"md","type":"string","enum":["sm","md","lg"]},"accentColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"buttonColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"payButtonText":{"default":"","type":"string","maxLength":40},"paymentTitle":{"default":"","type":"string","maxLength":60},"paymentText":{"default":"","type":"string","maxLength":240},"expressCheckout":{"default":true,"type":"boolean"},"socialProof":{"default":null,"anyOf":[{"type":"object","properties":{"rating":{"default":4.8,"type":"number","minimum":1,"maximum":5},"text":{"type":"string","minLength":1,"maxLength":80}},"required":["rating","text"],"additionalProperties":false},{"type":"null"}]},"trustNote":{"default":"","type":"string","maxLength":90},"policyLinks":{"default":true,"type":"boolean"},"radius":{"default":10,"type":"integer","minimum":0,"maximum":24},"banner":{"default":"","type":"string","maxLength":140},"paymentIcons":{"default":false,"type":"boolean"},"shippingNote":{"default":null,"anyOf":[{"type":"object","properties":{"icon":{"default":"shield","type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"default":"","type":"string","maxLength":80},"text":{"default":"","type":"string","maxLength":200}},"required":["icon","title","text"],"additionalProperties":false},{"type":"null"}]},"reviews":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"author":{"type":"string","minLength":1,"maxLength":60},"text":{"type":"string","minLength":1,"maxLength":280},"rating":{"default":5,"type":"integer","minimum":1,"maximum":5}},"required":["author","text","rating"],"additionalProperties":false}},"expressNote":{"default":"","type":"string","maxLength":100},"paymentLayout":{"default":"tabs","type":"string","enum":["accordion","tabs"]},"guaranteeNote":{"default":"","type":"string","maxLength":140},"benefits":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"icon":{"type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"type":"string","minLength":1,"maxLength":60},"text":{"default":"","type":"string","maxLength":160}},"required":["icon","title","text"],"additionalProperties":false}},"upsell":{"default":null,"anyOf":[{"type":"object","properties":{"source":{"default":"product","type":"string","enum":["product","same"]},"productId":{"default":"","type":"string","maxLength":100},"variantId":{"default":"","type":"string","pattern":"^(gid:\\/\\/shopify\\/ProductVariant\\/\\d+)?$"},"percentOff":{"default":0,"type":"integer","minimum":0,"maximum":90},"text":{"default":"","type":"string","maxLength":140}},"required":["source","productId","variantId","percentOff","text"],"additionalProperties":false},{"type":"null"}]},"timerMinutes":{"default":0,"type":"integer","minimum":0,"maximum":60}},"required":["logoUrl","logoSize","accentColor","buttonColor","payButtonText","paymentTitle","paymentText","expressCheckout","socialProof","trustNote","policyLinks","radius","banner","paymentIcons","shippingNote","reviews","expressNote","paymentLayout","guaranteeNote","benefits","upsell","timerMinutes"],"additionalProperties":false},"defaultAccent":{"type":"string"},"primaryLocale":{"type":["string","null"]},"otherLocales":{"type":"array","items":{"type":"string"}},"primaryCopy":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["enabled","stripeAccounts","shippingRates","countries","webhookUrl","shippingSource","shopifyShipping","shippingSyncError","appearance","defaultAccent","primaryLocale","otherLocales","primaryCopy"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/appearance":{"patch":{"operationId":"checkout.updateAppearance","summary":"Modifie l’apparence de la page de paiement Shopymake : logo, couleurs, arrondi, bandeau, paiement express, ligne d’avis, textes du paiement et du bouton, badges, logos de paiement, garantie, avis client, minuteur, liens des politiques. Les textes s’écrivent dans la langue principale de la boutique : ils sont traduits dans ses autres langues publiées. `logoUrl: null` revient au logo de la boutique.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"logoSize":{"default":"md","type":"string","enum":["sm","md","lg"]},"accentColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"buttonColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"payButtonText":{"default":"","type":"string","maxLength":40},"paymentTitle":{"default":"","type":"string","maxLength":60},"paymentText":{"default":"","type":"string","maxLength":240},"expressCheckout":{"default":true,"type":"boolean"},"socialProof":{"default":null,"anyOf":[{"type":"object","properties":{"rating":{"default":4.8,"type":"number","minimum":1,"maximum":5},"text":{"type":"string","minLength":1,"maxLength":80}},"required":["text"]},{"type":"null"}]},"trustNote":{"default":"","type":"string","maxLength":90},"policyLinks":{"default":true,"type":"boolean"},"radius":{"default":10,"type":"integer","minimum":0,"maximum":24},"banner":{"default":"","type":"string","maxLength":140},"paymentIcons":{"default":false,"type":"boolean"},"shippingNote":{"default":null,"anyOf":[{"type":"object","properties":{"icon":{"default":"shield","type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"default":"","type":"string","maxLength":80},"text":{"default":"","type":"string","maxLength":200}}},{"type":"null"}]},"reviews":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"author":{"type":"string","minLength":1,"maxLength":60},"text":{"type":"string","minLength":1,"maxLength":280},"rating":{"default":5,"type":"integer","minimum":1,"maximum":5}},"required":["author","text"]}},"expressNote":{"default":"","type":"string","maxLength":100},"paymentLayout":{"default":"tabs","type":"string","enum":["accordion","tabs"]},"guaranteeNote":{"default":"","type":"string","maxLength":140},"benefits":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"icon":{"type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"type":"string","minLength":1,"maxLength":60},"text":{"default":"","type":"string","maxLength":160}},"required":["icon","title"]}},"upsell":{"default":null,"anyOf":[{"type":"object","properties":{"source":{"default":"product","type":"string","enum":["product","same"]},"productId":{"default":"","type":"string","maxLength":100},"variantId":{"default":"","type":"string","pattern":"^(gid:\\/\\/shopify\\/ProductVariant\\/\\d+)?$"},"percentOff":{"default":0,"type":"integer","minimum":0,"maximum":90},"text":{"default":"","type":"string","maxLength":140}}},{"type":"null"}]},"timerMinutes":{"default":0,"type":"integer","minimum":0,"maximum":60},"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"logoUrl":{"type":"null"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"enabled":{"type":"boolean"},"stripeAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"publishableKey":{"type":"string"},"mode":{"type":"string","enum":["test","live"]},"isDefault":{"type":"boolean"},"marketIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","publishableKey","mode","isDefault","marketIds"],"additionalProperties":false}},"shippingRates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"countries":{"type":"array","items":{"type":"string"}},"webhookUrl":{"type":["string","null"]},"shippingSource":{"type":"string","enum":["shopify","manual"]},"shopifyShipping":{"anyOf":[{"type":"object","properties":{"model":{"type":"string","enum":["profiles","markets"]},"syncedAt":{"anyOf":[{},{"type":"null"}]},"countries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"zones":{"type":"array","items":{"type":"object","properties":{"profile":{"type":["string","null"]},"name":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"restOfWorld":{"type":"boolean"},"methods":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"currency":{"type":"string"},"basis":{"type":"string","enum":["flat","value","weight"]},"tiers":{"type":"array","items":{"type":"object","properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"price":{"type":"number"}},"required":["min","max","price"],"additionalProperties":false}},"freeAbove":{"type":["number","null"]},"byCollection":{"type":"boolean"}},"required":["name","currency","basis","tiers","freeAbove","byCollection"],"additionalProperties":false}}},"required":["profile","name","countries","restOfWorld","methods"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["model","syncedAt","countries","zones","warnings"],"additionalProperties":false},{"type":"null"}]},"shippingSyncError":{"type":["string","null"]},"appearance":{"type":"object","properties":{"logoUrl":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"logoSize":{"default":"md","type":"string","enum":["sm","md","lg"]},"accentColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"buttonColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"payButtonText":{"default":"","type":"string","maxLength":40},"paymentTitle":{"default":"","type":"string","maxLength":60},"paymentText":{"default":"","type":"string","maxLength":240},"expressCheckout":{"default":true,"type":"boolean"},"socialProof":{"default":null,"anyOf":[{"type":"object","properties":{"rating":{"default":4.8,"type":"number","minimum":1,"maximum":5},"text":{"type":"string","minLength":1,"maxLength":80}},"required":["rating","text"],"additionalProperties":false},{"type":"null"}]},"trustNote":{"default":"","type":"string","maxLength":90},"policyLinks":{"default":true,"type":"boolean"},"radius":{"default":10,"type":"integer","minimum":0,"maximum":24},"banner":{"default":"","type":"string","maxLength":140},"paymentIcons":{"default":false,"type":"boolean"},"shippingNote":{"default":null,"anyOf":[{"type":"object","properties":{"icon":{"default":"shield","type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"default":"","type":"string","maxLength":80},"text":{"default":"","type":"string","maxLength":200}},"required":["icon","title","text"],"additionalProperties":false},{"type":"null"}]},"reviews":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"author":{"type":"string","minLength":1,"maxLength":60},"text":{"type":"string","minLength":1,"maxLength":280},"rating":{"default":5,"type":"integer","minimum":1,"maximum":5}},"required":["author","text","rating"],"additionalProperties":false}},"expressNote":{"default":"","type":"string","maxLength":100},"paymentLayout":{"default":"tabs","type":"string","enum":["accordion","tabs"]},"guaranteeNote":{"default":"","type":"string","maxLength":140},"benefits":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"icon":{"type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"type":"string","minLength":1,"maxLength":60},"text":{"default":"","type":"string","maxLength":160}},"required":["icon","title","text"],"additionalProperties":false}},"upsell":{"default":null,"anyOf":[{"type":"object","properties":{"source":{"default":"product","type":"string","enum":["product","same"]},"productId":{"default":"","type":"string","maxLength":100},"variantId":{"default":"","type":"string","pattern":"^(gid:\\/\\/shopify\\/ProductVariant\\/\\d+)?$"},"percentOff":{"default":0,"type":"integer","minimum":0,"maximum":90},"text":{"default":"","type":"string","maxLength":140}},"required":["source","productId","variantId","percentOff","text"],"additionalProperties":false},{"type":"null"}]},"timerMinutes":{"default":0,"type":"integer","minimum":0,"maximum":60}},"required":["logoUrl","logoSize","accentColor","buttonColor","payButtonText","paymentTitle","paymentText","expressCheckout","socialProof","trustNote","policyLinks","radius","banner","paymentIcons","shippingNote","reviews","expressNote","paymentLayout","guaranteeNote","benefits","upsell","timerMinutes"],"additionalProperties":false},"defaultAccent":{"type":"string"},"primaryLocale":{"type":["string","null"]},"otherLocales":{"type":"array","items":{"type":"string"}},"primaryCopy":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},{"type":"null"}]},"translatedLocales":{"type":"array","items":{"type":"string"}},"translationError":{"type":["string","null"]}},"required":["enabled","stripeAccounts","shippingRates","countries","webhookUrl","shippingSource","shopifyShipping","shippingSyncError","appearance","defaultAccent","primaryLocale","otherLocales","primaryCopy","translatedLocales","translationError"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/logo":{"post":{"operationId":"checkout.setLogo","summary":"Envoie un logo propre à la page de paiement (fichiers Shopify), à la place de celui de la boutique. Image PNG, JPEG, WebP ou GIF, 3 Mo au plus, en base64.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"filename":{"type":"string","minLength":1,"maxLength":120},"mimeType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"dataBase64":{"type":"string","minLength":1,"maxLength":4000008}},"required":["shopId","filename","mimeType","dataBase64"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"logoUrl":{"type":"string"}},"required":["logoUrl"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/shipping/sync":{"post":{"operationId":"checkout.syncShipping","summary":"Relit dans Shopify les tarifs d’expédition de la boutique (profils d’expédition ou expédition par marché) pour le checkout Shopymake, puis republie les devises du checkout.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["shopId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"enabled":{"type":"boolean"},"stripeAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"publishableKey":{"type":"string"},"mode":{"type":"string","enum":["test","live"]},"isDefault":{"type":"boolean"},"marketIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","publishableKey","mode","isDefault","marketIds"],"additionalProperties":false}},"shippingRates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"countries":{"type":"array","items":{"type":"string"}},"webhookUrl":{"type":["string","null"]},"shippingSource":{"type":"string","enum":["shopify","manual"]},"shopifyShipping":{"anyOf":[{"type":"object","properties":{"model":{"type":"string","enum":["profiles","markets"]},"syncedAt":{"anyOf":[{},{"type":"null"}]},"countries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"zones":{"type":"array","items":{"type":"object","properties":{"profile":{"type":["string","null"]},"name":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"restOfWorld":{"type":"boolean"},"methods":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"currency":{"type":"string"},"basis":{"type":"string","enum":["flat","value","weight"]},"tiers":{"type":"array","items":{"type":"object","properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"price":{"type":"number"}},"required":["min","max","price"],"additionalProperties":false}},"freeAbove":{"type":["number","null"]},"byCollection":{"type":"boolean"}},"required":["name","currency","basis","tiers","freeAbove","byCollection"],"additionalProperties":false}}},"required":["profile","name","countries","restOfWorld","methods"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["model","syncedAt","countries","zones","warnings"],"additionalProperties":false},{"type":"null"}]},"shippingSyncError":{"type":["string","null"]},"appearance":{"type":"object","properties":{"logoUrl":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"logoSize":{"default":"md","type":"string","enum":["sm","md","lg"]},"accentColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"buttonColor":{"default":null,"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"payButtonText":{"default":"","type":"string","maxLength":40},"paymentTitle":{"default":"","type":"string","maxLength":60},"paymentText":{"default":"","type":"string","maxLength":240},"expressCheckout":{"default":true,"type":"boolean"},"socialProof":{"default":null,"anyOf":[{"type":"object","properties":{"rating":{"default":4.8,"type":"number","minimum":1,"maximum":5},"text":{"type":"string","minLength":1,"maxLength":80}},"required":["rating","text"],"additionalProperties":false},{"type":"null"}]},"trustNote":{"default":"","type":"string","maxLength":90},"policyLinks":{"default":true,"type":"boolean"},"radius":{"default":10,"type":"integer","minimum":0,"maximum":24},"banner":{"default":"","type":"string","maxLength":140},"paymentIcons":{"default":false,"type":"boolean"},"shippingNote":{"default":null,"anyOf":[{"type":"object","properties":{"icon":{"default":"shield","type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"default":"","type":"string","maxLength":80},"text":{"default":"","type":"string","maxLength":200}},"required":["icon","title","text"],"additionalProperties":false},{"type":"null"}]},"reviews":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"author":{"type":"string","minLength":1,"maxLength":60},"text":{"type":"string","minLength":1,"maxLength":280},"rating":{"default":5,"type":"integer","minimum":1,"maximum":5}},"required":["author","text","rating"],"additionalProperties":false}},"expressNote":{"default":"","type":"string","maxLength":100},"paymentLayout":{"default":"tabs","type":"string","enum":["accordion","tabs"]},"guaranteeNote":{"default":"","type":"string","maxLength":140},"benefits":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"icon":{"type":"string","enum":["shield","heart","leaf","sparkles","droplet","truck","star","gift","clock","award","smile","zap"]},"title":{"type":"string","minLength":1,"maxLength":60},"text":{"default":"","type":"string","maxLength":160}},"required":["icon","title","text"],"additionalProperties":false}},"upsell":{"default":null,"anyOf":[{"type":"object","properties":{"source":{"default":"product","type":"string","enum":["product","same"]},"productId":{"default":"","type":"string","maxLength":100},"variantId":{"default":"","type":"string","pattern":"^(gid:\\/\\/shopify\\/ProductVariant\\/\\d+)?$"},"percentOff":{"default":0,"type":"integer","minimum":0,"maximum":90},"text":{"default":"","type":"string","maxLength":140}},"required":["source","productId","variantId","percentOff","text"],"additionalProperties":false},{"type":"null"}]},"timerMinutes":{"default":0,"type":"integer","minimum":0,"maximum":60}},"required":["logoUrl","logoSize","accentColor","buttonColor","payButtonText","paymentTitle","paymentText","expressCheckout","socialProof","trustNote","policyLinks","radius","banner","paymentIcons","shippingNote","reviews","expressNote","paymentLayout","guaranteeNote","benefits","upsell","timerMinutes"],"additionalProperties":false},"defaultAccent":{"type":"string"},"primaryLocale":{"type":["string","null"]},"otherLocales":{"type":"array","items":{"type":"string"}},"primaryCopy":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},{"type":"null"}]},"error":{"type":["string","null"]}},"required":["enabled","stripeAccounts","shippingRates","countries","webhookUrl","shippingSource","shopifyShipping","shippingSyncError","appearance","defaultAccent","primaryLocale","otherLocales","primaryCopy","error"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/payment-methods":{"get":{"operationId":"checkout.paymentMethods","summary":"Moyens de paiement réellement proposables par le compte Stripe de chaque marché actif (et par le compte par défaut pour les autres), avec l’ordre d’affichage choisi : le premier est ouvert et présélectionné.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"countries":{"type":"array","items":{"type":"string"}},"account":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"available":{"type":"array","items":{"type":"string"}},"order":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]}},"required":["id","name","countries","account","available","order","error"],"additionalProperties":false}}},"required":["markets"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkout/payment-order":{"post":{"operationId":"checkout.setPaymentOrder","summary":"Ordre des moyens de paiement d’un marché (GID) ou `default` : types Stripe (`twint`, `card`, `paypal`…), le premier ouvert et présélectionné sur la page de paiement. Liste vide : ordre de Stripe.","tags":["checkout"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"market":{"anyOf":[{"type":"string","const":"default"},{"type":"string","pattern":"^gid:\\/\\/shopify\\/Market\\/\\d+$"}]},"order":{"maxItems":40,"type":"array","items":{"type":"string","pattern":"^[a-z_]{2,40}$"}}},"required":["shopId","market","order"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"order":{"type":"array","items":{"type":"string"}}},"required":["order"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkouts":{"get":{"operationId":"checkouts.list","summary":"Checkouts externes d’une boutique (plus récents d’abord), avec leur commande Shopify.","tags":["checkouts"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["open","completing","completed","order_failed"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["open","completing","completed","order_failed"]},"email":{"type":["string","null"]},"currency":{"type":"string"},"total":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"orderName":{"type":["string","null"]},"error":{"type":["string","null"]},"abandoned":{"type":"boolean"},"createdAt":{},"updatedAt":{}},"required":["id","status","email","currency","total","orderName","error","abandoned","createdAt","updatedAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/checkouts/abandoned":{"get":{"operationId":"checkouts.listAbandoned","summary":"Paniers abandonnés d’une boutique (e-mail saisi, pas de paiement) : en attente, transmis à Shopify pour les relances, ou récupérés ; date de la dernière transmission.","tags":["checkouts"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"afterMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"everyMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastTransmittedAt":{"anyOf":[{},{"type":"null"}]},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"currency":{"type":"string"},"total":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"status":{"type":"string","enum":["waiting","transmitted","recovered"]},"updatedAt":{},"transmittedAt":{"anyOf":[{},{"type":"null"}]},"draftOrderId":{"type":["string","null"]},"orderName":{"type":["string","null"]}},"required":["id","email","currency","total","status","updatedAt","transmittedAt","draftOrderId","orderName"],"additionalProperties":false}}},"required":["afterMinutes","everyMinutes","lastTransmittedAt","rows"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/checkouts/{id}/retry":{"post":{"operationId":"checkouts.retryOrder","summary":"Relance la création de la commande Shopify d’un checkout payé dont la commande a échoué.","tags":["checkouts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","enum":["open","completing","completed","order_failed"]},"orderName":{"type":["string","null"]},"error":{"type":["string","null"]}},"required":["status","orderName","error"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/checkouts/process-abandoned":{"post":{"operationId":"checkouts.processAbandoned","summary":"Envoie vers Shopify (client + brouillon étiqueté checkout-abandonne) les checkouts abandonnés.","tags":["checkouts"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"minutes":{"default":60,"type":"integer","minimum":15,"maximum":10080},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"processed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"error":{"type":"string"}},"required":["id","error"],"additionalProperties":false}}},"required":["processed","failed"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/tracking/settings":{"get":{"operationId":"tracking.settings","summary":"Pixels et envois serveur configurés pour le checkout Shopymake d’une boutique (sans les jetons) ; actifs seulement si ce checkout est activé.","tags":["tracking"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"checkoutEnabled":{"type":"boolean"},"metaPixelId":{"type":["string","null"]},"hasMetaAccessToken":{"type":"boolean"},"metaTestEventCode":{"type":["string","null"]},"tiktokPixelCode":{"type":["string","null"]},"hasTiktokAccessToken":{"type":"boolean"},"ga4MeasurementId":{"type":["string","null"]},"hasGa4ApiSecret":{"type":"boolean"},"googleAdsId":{"type":["string","null"]},"googleAdsPurchaseLabel":{"type":["string","null"]}},"required":["checkoutEnabled","metaPixelId","hasMetaAccessToken","metaTestEventCode","tiktokPixelCode","hasTiktokAccessToken","ga4MeasurementId","hasGa4ApiSecret","googleAdsId","googleAdsPurchaseLabel"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/tracking/events":{"get":{"operationId":"tracking.events","summary":"Journal des envois serveur du tracking (Meta, TikTok, GA4) : envoyé, en échec ou ignoré faute de consentement.","tags":["tracking"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["meta","tiktok","ga4"]},"eventName":{"type":"string"},"eventId":{"type":"string"},"status":{"type":"string","enum":["sent","failed","skipped"]},"detail":{"type":["string","null"]},"createdAt":{}},"required":["id","provider","eventName","eventId","status","detail","createdAt"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/maintenance/purge":{"post":{"operationId":"maintenance.purge","summary":"Supprime les données techniques expirées : compteurs de débit, notifications (30 j), journal de tracking (90 j), checkouts anonymes (30 j).","tags":["maintenance"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rateLimits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"webhookEvents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"trackingEvents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"oauthStates":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"anonymousCheckouts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rateLimits","webhookEvents","trackingEvents","oauthStates","anonymousCheckouts"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/gifts":{"get":{"operationId":"gifts.list","summary":"Catalogue de cadeaux d’une boutique : vrais produits Shopify offerts dans les offres, avec leur clé (utilisée par les modèles) et les offres qui les utilisent.","tags":["gifts"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArchived","in":"query","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"shopId":{"type":"string"},"key":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string","enum":["physical","digital","gift_card"]},"productId":{"type":"string"},"variantId":{"type":"string"},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"imageUrl":{"type":["string","null"]},"managed":{"type":"boolean"},"status":{"type":"string","enum":["active","archived"]},"usedBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"additionalProperties":false}}},"required":["id","shopId","key","title","kind","productId","variantId","value","imageUrl","managed","status","usedBy"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"gifts.create","summary":"Crée un cadeau : un produit Shopify non publié sur la boutique en ligne (étiquette shopymake-gift), avec sa valeur affichée. Digital et carte cadeau : pas d’expédition.","tags":["gifts"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":120},"kind":{"default":"physical","type":"string","enum":["physical","digital","gift_card"]},"value":{"type":"integer","minimum":0,"maximum":10000000},"imageUrl":{"type":"string","maxLength":2000,"format":"uri"},"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"sku":{"type":"string","maxLength":100},"trackInventory":{"default":false,"type":"boolean"}},"required":["shopId","title","value"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"shopId":{"type":"string"},"key":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string","enum":["physical","digital","gift_card"]},"productId":{"type":"string"},"variantId":{"type":"string"},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"imageUrl":{"type":["string","null"]},"managed":{"type":"boolean"},"status":{"type":"string","enum":["active","archived"]},"usedBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"additionalProperties":false}}},"required":["id","shopId","key","title","kind","productId","variantId","value","imageUrl","managed","status","usedBy"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/gifts/import":{"post":{"operationId":"gifts.import","summary":"Ajoute au catalogue de cadeaux une variante existante de la boutique (e-book, carte cadeau, accessoire déjà créés dans Shopify).","tags":["gifts"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"variantId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/ProductVariant\\/\\d+$"},"kind":{"default":"physical","type":"string","enum":["physical","digital","gift_card"]},"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"value":{"type":"integer","minimum":0,"maximum":10000000}},"required":["shopId","variantId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"shopId":{"type":"string"},"key":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string","enum":["physical","digital","gift_card"]},"productId":{"type":"string"},"variantId":{"type":"string"},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"imageUrl":{"type":["string","null"]},"managed":{"type":"boolean"},"status":{"type":"string","enum":["active","archived"]},"usedBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"additionalProperties":false}}},"required":["id","shopId","key","title","kind","productId","variantId","value","imageUrl","managed","status","usedBy"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/gifts/{id}":{"patch":{"operationId":"gifts.update","summary":"Modifie un cadeau : titre, valeur, clé, type, image affichée. Pour un cadeau créé par Shopymake, le titre et le prix du produit Shopify suivent.","tags":["gifts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":120},"value":{"type":"integer","minimum":0,"maximum":10000000},"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"kind":{"type":"string","enum":["physical","digital","gift_card"]},"imageUrl":{"anyOf":[{"type":"string","maxLength":2000,"format":"uri"},{"type":"null"}]}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"shopId":{"type":"string"},"key":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string","enum":["physical","digital","gift_card"]},"productId":{"type":"string"},"variantId":{"type":"string"},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"imageUrl":{"type":["string","null"]},"managed":{"type":"boolean"},"status":{"type":"string","enum":["active","archived"]},"usedBy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"additionalProperties":false}}},"required":["id","shopId","key","title","kind","productId","variantId","value","imageUrl","managed","status","usedBy"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/gifts/{id}/archive":{"post":{"operationId":"gifts.archive","summary":"Retire un cadeau du catalogue (refusé s’il est utilisé par une offre active). Un cadeau créé par Shopymake est archivé dans Shopify.","tags":["gifts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["id"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"archived":{"type":"boolean"}},"required":["archived"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/products/variants":{"get":{"operationId":"products.variants","summary":"Variantes d’un produit de la boutique (identifiant, titre, prix, disponibilité, options, image) : pour choisir un produit proposé en option ou un cadeau, et pour l’aperçu des bundles.","tags":["products"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"available":{"type":"boolean"},"selectedOptions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}},"image":{"type":["string","null"]}},"required":["id","title","price","available","selectedOptions","image"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/subscription-plans":{"get":{"operationId":"offers.subscriptionPlans","summary":"Plans d’abonnement (selling plans de l’app d’abonnement, ex. Shopify Subscriptions) des produits d’un bundle : boutique éligible à l’abonnement, plans de chaque produit et leur remise, produit vendu seulement en abonnement, checkout Shopymake actif (incompatible avec l’abonnement).","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"productIds","in":"query","required":true,"schema":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"eligible":{"type":"boolean"},"shopymakeCheckout":{"type":"boolean"},"products":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"title":{"type":"string"},"requiresSellingPlan":{"type":"boolean"},"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"},"appId":{"type":["string","null"]},"percentOff":{"type":"number"}},"required":["id","name","group","appId","percentOff"],"additionalProperties":false}}},"required":["productId","title","requiresSellingPlan","plans"],"additionalProperties":false}}},"required":["eligible","shopymakeCheckout","products"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/integrate":{"post":{"operationId":"theme.integrate","summary":"Intègre Shopymake à un thème non publié (Shrine PRO ou dérivé de Dawn) en une fois : installe ou met à jour le kit sm-*, ajoute le bundle et la note à toutes les fiches produit compatibles et la section panier (cadeaux, checkout) au pied de page. Le code du thème n’est pas modifié.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"themeId":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"},"waitForCopy":{"default":false,"type":"boolean"}},"required":["shopId","themeId"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kitVersion":{"type":"string"},"kitFiles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"templates":{"type":"object","properties":{"enabled":{"type":"array","items":{"type":"string"}},"already":{"type":"array","items":{"type":"string"}},"skipped":{"type":"array","items":{"type":"string"}}},"required":["enabled","already","skipped"],"additionalProperties":false},"cart":{"anyOf":[{"type":"string","enum":["footer","cart_template"]},{"type":"null"}]}},"required":["kitVersion","kitFiles","templates","cart"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/themes/integration":{"get":{"operationId":"theme.integrationStatus","summary":"État de Shopymake dans un thème tiers : kit absent, à mettre à jour ou à jour ; bundle sur la fiche produit par défaut ; section panier présente.","tags":["theme"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"themeId","in":"query","required":true,"schema":{"type":"string","pattern":"^gid:\\/\\/shopify\\/OnlineStoreTheme\\/\\d+$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kit":{"type":"string","enum":["missing","outdated","current"]},"product":{"type":"boolean"},"cart":{"type":"boolean"}},"required":["kit","product","cart"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/offer-templates":{"get":{"operationId":"offerTemplates.list","summary":"Modèles d’offres : modèles prêts à l’emploi (BOGO, 2 + 1 offert, quantité dégressive, 2e à moitié prix, packs à prix ronds, cadeaux progressifs) et modèles enregistrés par l’équipe.","tags":["offerTemplates"],"parameters":[{"name":"locale","in":"query","required":false,"schema":{"default":"fr","type":"string","pattern":"^[a-z]{2}(-[A-Za-z]{2,4})?$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["system","custom"]},"name":{"type":"string"},"description":{"type":["string","null"]},"inspiredBy":{"type":["string","null"]},"giftKeys":{"type":"array","items":{"type":"string"}},"definition":{"type":"object","properties":{"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","freeShipping","display","gifts"],"additionalProperties":false}},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false}},"required":["mixAndMatch","tiers","rounding","display"],"additionalProperties":false}},"required":["id","source","name","description","inspiredBy","giftKeys","definition"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"offerTemplates.save","summary":"Enregistre un modèle d’offre réutilisable dans toutes les boutiques : à partir d’une définition, ou d’une offre existante (`fromOfferId`, ses cadeaux deviennent des clés de catalogue). Avec `id` : remplace un modèle de l’équipe.","tags":["offerTemplates"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":500},"definition":{"type":"object","properties":{"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"]},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"]},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"]}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}}},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey"]}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey"]}},"label":{"type":"string","maxLength":200}},"required":["options"]}},"required":["id","label","buyQuantity"]}},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"]}}}},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type"]}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}}}},"required":["tiers"]},"fromOfferId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["name"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["system","custom"]},"name":{"type":"string"},"description":{"type":["string","null"]},"inspiredBy":{"type":["string","null"]},"giftKeys":{"type":"array","items":{"type":"string"}},"definition":{"type":"object","properties":{"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","freeShipping","display","gifts"],"additionalProperties":false}},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false}},"required":["mixAndMatch","tiers","rounding","display"],"additionalProperties":false},"unknownGifts":{"type":"array","items":{"type":"string"}}},"required":["id","source","name","description","inspiredBy","giftKeys","definition","unknownGifts"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/offer-templates/{id}":{"get":{"operationId":"offerTemplates.get","summary":"Détail d’un modèle d’offre (système `system:…` ou modèle de l’équipe).","tags":["offerTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"query","required":false,"schema":{"default":"fr","type":"string","pattern":"^[a-z]{2}(-[A-Za-z]{2,4})?$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["system","custom"]},"name":{"type":"string"},"description":{"type":["string","null"]},"inspiredBy":{"type":["string","null"]},"giftKeys":{"type":"array","items":{"type":"string"}},"definition":{"type":"object","properties":{"mixAndMatch":{"default":false,"type":"boolean"},"tiers":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"giftKey":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,39}$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20}},"required":["giftKey","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","freeShipping","display","gifts"],"additionalProperties":false}},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false}},"required":["mixAndMatch","tiers","rounding","display"],"additionalProperties":false}},"required":["id","source","name","description","inspiredBy","giftKeys","definition"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"delete":{"operationId":"offerTemplates.delete","summary":"Supprime un modèle de l’équipe (les offres créées avec restent inchangées).","tags":["offerTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offer-templates/{templateId}/instantiate":{"get":{"operationId":"offerTemplates.instantiate","summary":"Paliers concrets d’un modèle pour une boutique, sans rien créer : textes dans la langue de la boutique, cadeaux résolus dans son catalogue (clés absentes signalées). Pour pré-remplir un éditeur ou vérifier un modèle.","tags":["offerTemplates"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"templateId":{"type":"string"},"name":{"type":"string"},"mixAndMatch":{"type":"boolean"},"rounding":{"default":"none","type":"string","enum":["90","99","none","00"]},"display":{"default":{"layout":"vertical","variantMode":"per_unit","optionStyles":{},"fields":[],"showUnitPrice":true,"showCompareAt":true,"giftsInTiers":true,"giftsStrip":true,"showTimer":false},"type":"object","properties":{"layout":{"default":"vertical","type":"string","enum":["vertical","horizontal"]},"style":{"type":"object","properties":{"layout":{"type":"string","enum":["list","cards","grid","compact"]},"columns":{"type":"integer","minimum":1,"maximum":4},"radius":{"type":"integer","minimum":0,"maximum":32},"spacing":{"type":"integer","minimum":0,"maximum":32},"perks":{"type":"string","enum":["band","inline"]},"pill":{"type":"string","enum":["below","inline"]},"colors":{"type":"object","propertyNames":{"type":"string","enum":["cardBg","selectedBg","border","selectedBorder","blockTitle","title","subtitle","price","compareAt","labelBg","labelText","badgeBg","badgeText","accent","giftBg","giftText","giftSelectedBg","giftSelectedText","upsellBg","upsellText","upsellSelectedBg","upsellSelectedText","swatchBg","swatchText","swatchBorder","timerBg","timerText"]},"additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"fonts":{"type":"object","propertyNames":{"type":"string","enum":["blockTitle","title","subtitle","label","price","gift","upsell","unit"]},"additionalProperties":{"type":"object","properties":{"size":{"type":"integer","minimum":10,"maximum":40},"weight":{"type":"string","enum":["regular","medium","bold"]}},"required":["size","weight"],"additionalProperties":false}}},"additionalProperties":false},"heading":{"type":"string","maxLength":120},"subheading":{"type":"string","maxLength":200},"variantMode":{"default":"per_unit","type":"string","enum":["per_unit","single"]},"optionStyles":{"default":{},"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"type":"string","enum":["auto","image","buttons","dropdown"]}},"fields":{"default":[],"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":60},"type":{"type":"string","enum":["text","file"]},"placeholder":{"type":"string","maxLength":80},"required":{"default":false,"type":"boolean"},"perUnit":{"default":true,"type":"boolean"},"maxLength":{"default":40,"type":"integer","minimum":1,"maximum":200}},"required":["id","label","type","required","perUnit","maxLength"],"additionalProperties":false}},"showUnitPrice":{"default":true,"type":"boolean"},"showCompareAt":{"default":true,"type":"boolean"},"giftsInTiers":{"default":true,"type":"boolean"},"giftsStrip":{"default":true,"type":"boolean"},"giftsStripHeading":{"type":"string","maxLength":120},"showTimer":{"default":false,"type":"boolean"},"timerText":{"type":"string","maxLength":80},"translations":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})?$"},"additionalProperties":{"type":"object","propertyNames":{"type":"string","maxLength":400},"additionalProperties":{"type":"string","maxLength":400}}}},"required":["layout","variantMode","optionStyles","fields","showUnitPrice","showCompareAt","giftsInTiers","giftsStrip","showTimer"],"additionalProperties":false},"tiers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":120},"buyQuantity":{"type":"integer","minimum":1,"maximum":100},"freeQuantity":{"default":0,"type":"integer","minimum":0,"maximum":100},"freeDiscountPercent":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":100},"discount":{"default":{"type":"none"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"fixed_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"amount_off"},"amounts":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","amounts"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"unit_price"},"prices":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z]{3}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["type","prices"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"multiplier"},"value":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["type","value"],"additionalProperties":false}]},"badge":{"type":"string","maxLength":60},"highlighted":{"default":false,"type":"boolean"},"gifts":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"giftChoice":{"type":"object","properties":{"options":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","minLength":1,"maxLength":100},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","maxLength":200},"giftId":{"type":"string","minLength":1,"maxLength":100}},"required":["variantId","quantity"],"additionalProperties":false}},"label":{"type":"string","maxLength":200}},"required":["options"],"additionalProperties":false},"freeShipping":{"default":false,"type":"boolean"},"display":{"default":{"badgeStyle":"pill","highlights":[],"image":"product","preselected":false},"type":"object","properties":{"title":{"type":"string","maxLength":120},"subtitle":{"type":"string","maxLength":160},"pill":{"type":"string","maxLength":80},"badgeStyle":{"default":"pill","type":"string","enum":["pill","ribbon","marquee","block"]},"highlights":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"image":{"default":"product","type":"string","enum":["product","none"]},"preselected":{"default":false,"type":"boolean"}},"required":["badgeStyle","highlights","image","preselected"],"additionalProperties":false}},"required":["id","label","buyQuantity","freeQuantity","freeDiscountPercent","discount","highlighted","gifts","freeShipping","display"],"additionalProperties":false}},"missingGiftKeys":{"type":"array","items":{"type":"string"}}},"required":["templateId","name","mixAndMatch","rounding","display","tiers","missingGiftKeys"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/offers/from-template":{"post":{"operationId":"offers.createFromTemplate","summary":"Crée à partir d’un modèle le bundle de chaque produit (un par produit, nommé comme lui ; ADR 0037) : textes dans la langue de la boutique, cadeaux résolus par leur clé dans le catalogue de cadeaux (clés absentes signalées). Produits qui ont déjà un bundle : laissés tels quels et listés. Créés en brouillon par défaut.","tags":["offers"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"templateId":{"type":"string","minLength":1,"maxLength":100},"productIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^gid:\\/\\/shopify\\/Product\\/\\d+$"}},"status":{"default":"draft","type":"string","enum":["active","draft"]}},"required":["shopId","templateId","productIds"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offerId":{"type":"string"},"offerIds":{"type":"array","items":{"type":"string"}},"skipped":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"bundle":{"type":"string"}},"required":["productId","bundle"],"additionalProperties":false}},"failed":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"error":{"type":"string"}},"required":["productId","error"],"additionalProperties":false}},"missingGiftKeys":{"type":"array","items":{"type":"string"}}},"required":["offerId","offerIds","skipped","failed","missingGiftKeys"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/calendar":{"get":{"operationId":"calendar.get","summary":"Calendrier des offres d’une boutique : périodes (temps forts), période en cours (annoncée en haut de la boutique) et suivante.","tags":["calendar"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false}},"today":{"type":"string"},"current":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"next":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"countries":{"type":"array","items":{"type":"string"}},"timezone":{"type":["string","null"]}},"required":["periods","today","current","next","countries","timezone"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}},"post":{"operationId":"calendar.save","summary":"Remplace le calendrier des offres d’une boutique (périodes « AAAA-MM-JJ », fin incluse, sans chevauchement) et le publie sur la boutique : la période en cours s’affiche dans le bandeau d’annonce, avec compte à rebours facultatif ; une vente flash répétée (flash) ne l’affiche que pendant ses fenêtres de chaque jour, une pause entre deux.","tags":["calendar"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shopId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"periods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":40},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"anyOf":[{"type":"object","properties":{"everyHours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startHour":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"durationHours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["everyHours","startHour","durationHours"]},{"type":"null"}]}},"required":["name","start","end"]}}},"required":["shopId","periods"]}}}},"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false}},"today":{"type":"string"},"current":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"next":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"banner":{"type":"string"},"link":{"type":"string"},"countdown":{"type":"boolean"},"flash":{"type":"object","properties":{"everyHours":{"type":"number"},"startHour":{"type":"number"},"durationHours":{"type":"number"}},"required":["everyHours","startHour","durationHours"],"additionalProperties":false},"startsAt":{"type":"string"},"endsAt":{"type":"string"}},"required":["id","name","start","end","countdown","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"countries":{"type":"array","items":{"type":"string"}},"timezone":{"type":["string","null"]},"publishWarning":{"type":["string","null"]}},"required":["periods","today","current","next","countries","timezone","publishWarning"],"additionalProperties":false}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/shops/{shopId}/calendar/presets":{"get":{"operationId":"calendar.presets","summary":"Temps forts d’une année (soldes, Saint-Valentin, fêtes des mères et des pères, rentrée, Singles’ Day, Black Friday, Noël) pour un pays, ajustés aux jours libres du calendrier. Ne modifie rien : à ajouter avec calendar.save.","tags":["calendar"],"parameters":[{"name":"shopId","in":"path","required":true,"schema":{"type":"string"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":2020,"maximum":2100}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Z]{2}$"}}],"responses":{"200":{"description":"Succès","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"}},"required":["key","name","start","end"],"additionalProperties":false}}}}}}},"default":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}}}}