Que contrôle le réglage de redirection www de BigCommerce pour un canal headless ?

Définition : BigCommerce décrit www_redirect comme un réglage propre à un canal à architecture découplée (headless), qui s’applique à son URL unique de tunnel de commande (checkout). Le point de terminaison de mise à jour accepte les valeurs www, no-www ou none pour ce champ.

Points clés

• La référence Update Storefront SEO Settings de BigCommerce indique que le point de terminaison est PUT /v3/settings/storefront/seo et décrit www_redirect comme le réglage de l’URL unique du tunnel de commande d’un canal headless.
• La référence Get Storefront SEO Settings, qui lui est associée, utilise channel_id pour récupérer les valeurs propres à un canal. Sans ce paramètre, la requête porte sur les réglages globaux.
• La référence de mise à jour donne www, no-www et none comme valeurs autorisées pour www_redirect.
• Le guide de configuration des canaux headless de BigCommerce traite le domaine de la boutique en ligne et celui du tunnel de commande comme deux étapes de configuration distinctes du canal.
• Le guide Checkout Domains précise que le domaine du tunnel de commande est une propriété du canal et doit partager un même domaine principal avec l’URL de la boutique en ligne du canal.

À quelle URL le réglage s’applique-t-il ?

Le réglage concerne le nom d’hôte utilisé pour le tunnel de commande hébergé d’un canal headless. Le guide de configuration des canaux de BigCommerce précise que les pages du tunnel de commande sont hébergées et que le domaine du tunnel de commande d’une boutique headless est défini via le point de terminaison de l’URL du tunnel de commande du site du canal. Le même guide renvoie à l’API Settings pour configurer le réglage www_redirect de cette URL.

L’URL de la boutique en ligne et celle du tunnel de commande ont des rôles distincts. La première identifie le site headless, tandis que la seconde identifie le domaine sur lequel BigCommerce sert le tunnel de commande. Le guide Checkout Domains de BigCommerce décrit le tunnel de commande comme une propriété du canal et précise que son URL doit partager un même domaine principal avec l’URL de la boutique en ligne. Une boutique à l’adresse www.example.com peut donc utiliser checkout.example.com conformément à cette règle documentée de domaine commun.

Comment transmettre www_redirect à l’API ?

L’opération de mise à jour utilise une requête PUT. BigCommerce documente channel_id comme paramètre de requête pour les réglages propres à un canal et précise séparément qu’un canal headless peut utiliser channel_id dans le corps de la requête pour contrôler ce réglage du tunnel de commande. Le corps de la requête utilise le champ www_redirect :

{
  "www_redirect": "no-www"
}

La référence énumère trois valeurs possibles : www, no-www et none. Leurs noms identifient la forme du nom d’hôte proposée par le réglage. La référence ne décrit pas la séquence de redirection pour chaque valeur, notamment le nom d’hôte qui reçoit la redirection ou le code de réponse utilisé.

Le point de terminaison exige l’en-tête X-Auth-Token. Dans les détails d’authentification, BigCommerce indique la portée d’autorisation (scope) de modification store_v2_information et la portée store_v2_information_read_only.

Comment fonctionne l’héritage des réglages du canal ?

La référence de mise à jour précise que null supprime une surcharge (override) pour un canal et rétablit l’héritage du réglage global. La référence de lecture décrit le comportement correspondant : lorsque les réglages d’un canal sont demandés, null indique qu’un champ ne possède pas de surcharge propre au canal et hérite de la valeur globale.

Une vérification propre à un canal nécessite donc son identifiant. L’opération de lecture documentée est la suivante :

GET https://api.bigcommerce.com/stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}
Accept: application/json

Si la valeur renvoyée pour www_redirect est null, BigCommerce décrit cet état comme un héritage. Si la réponse contient www, no-www ou none, le canal possède une valeur pour ce champ. Le schéma de réponse place www_redirect aux côtés de meta_description, meta_keywords et page_title dans SEOSettings.

Questions fréquentes

Ce réglage modifie-t-il le domaine de la boutique headless ?

Non. La documentation associe ce réglage à l’URL unique du tunnel de commande du canal headless. BigCommerce configure l’URL de la boutique headless et celle du tunnel de commande au moyen d’opérations distinctes sur le site du canal.

Que fait la valeur none ?

none est l’une des trois valeurs autorisées. La référence de BigCommerce ne définit pas précisément son comportement de redirection : il convient donc de le vérifier dans la réponse observée du tunnel de commande du canal avant d’associer cette valeur à une règle précise de nom d’hôte.

Comment savoir si un canal surcharge la valeur globale ?

Demandez les réglages SEO de la boutique en ligne avec channel_id. Selon la référence de lecture de BigCommerce, un champ à null signifie que la valeur du canal est héritée du réglage global.

Termes associés

• Comment une agence peut-elle vérifier si les paramètres SEO d’un canal BigCommerce héritent des valeurs globales ?
• Comment supprimer une surcharge SEO de canal dans BigCommerce ?
• Comment une vitrine découplée (headless) BigCommerce retrouve-t-elle une page à partir d’un chemin d’URL ?

Sources

1. BigCommerce, « Update Storefront SEO Settings », sans date
2. BigCommerce, « Get Storefront SEO Settings », sans date
3. BigCommerce, « Creating Channels », sans date
4. BigCommerce, « Checkout Domains », sans date

---

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO