Créer une marque

Crée une marque : l’objet de premier niveau de l’API Social. Une marque possède les comptes sociaux que vous y connectez et toutes les publications publiées depuis ces comptes. Aucun autre appel à l’API Social n’est possible tant qu’il n’existe pas au moins une marque ; il s’agit donc de la première requête de toute intégration Social.

Cas d’utilisation : intégrer un client à la publication sur les réseaux sociaux. Lorsqu’un client s’inscrit à votre produit, créez une marque pour chaque entreprise pour laquelle il souhaite publier. Enregistrez la valeur socialProfile.id renvoyée dans votre propre enregistrement de cette entreprise : elle correspond au paramètre de chemin brandId dans POST /social/brands/{brandId}/connections/link et GET /social/brands/{brandId}/posts, ainsi qu’au champ socialProfileId du corps de chaque publication que vous créez. Dirigez ensuite l’utilisateur vers le lien de connexion hébergé pour chaque plateforme sur laquelle il souhaite publier.

Remarques.

• Le corps de la requête doit être encapsulé dans un objet input. Toutes les opérations d’écriture de l’API Social utilisent cette encapsulation, à une exception près : le lien de connexion accepte un corps sans encapsulation.
• Vérifiez success, pas le statut HTTP. Un échec de validation — une valeur profileName manquante ou une valeur timezone.tzCode inconnue — renvoie HTTP 200 avec success: false et le motif dans error. Ne considérez l’appel comme réussi que lorsque success vaut true.
• Seuls profileName et timezone sont obligatoires. Les valeurs par défaut de businessIntent et de categories sont respectivement general et une liste vide ; une intégration qui ne possède aucun équivalent de ces champs peut donc les omettre entièrement.
• timezone.tzCode n’est pas un simple élément décoratif. Une publication programmée avec scheduleDate + scheduleTime est interprétée dans le fuseau horaire de la marque, et non dans celui de l’appelant ni en UTC. Une modification ultérieure de ce fuseau horaire ne change pas l’heure des publications déjà programmées.
• La marque appartient toujours au compte associé à la clé API. Il n’est pas possible de créer une marque dans un autre compte : tout identifiant de compte présent dans le corps est ignoré.
• Les identifiants de marque sont de simples UUID. Ce ne sont pas les identifiants Relay en Base64 utilisés par Locations et les Posts d’établissement ; ne les encodez et ne les décodez donc pas. Le même identifiant apparaît comme paramètre de chemin brandId et comme champ socialProfileId du corps : brandId est toujours un paramètre d’URL, jamais un champ du corps.
• Les forfaits API n’imposent aucune limite au nombre de marques. Les marques sont illimitées et ne sont pas décomptées ; cet appel n’est donc jamais refusé en raison d’un plafond, et vous n’avez pas besoin de vérifier la capacité restante avant d’en créer une. Ce sont les connexions qui sont décomptées — un compte social lié à une marque sur un réseau. Consultez Forfaits et options supplémentaires pour connaître les paliers de connexions et le prix d’un pack de connexions, et GET /social/limits pour vérifier votre capacité de connexion restante avant de diriger un utilisateur vers un lien de connexion.

Opération d’écriture : non exécutée sur le compte réel. La requête et la réponse présentées sont construites à partir du schéma de l’API.