Méthode GET/distributor-portal/brands

Lister les marques pour lesquelles vous êtes un contact actif, pour construire un sélecteur. Session de compte contact distributeur.

Sur cette page

Vous listez chaque marque pour laquelle votre compte est un contact distributeur ACTIF (ni en attente, ni révoqué). C'est l'appel qui alimente un sélecteur de marque : une entreprise de distribution porte souvent plusieurs marques à la fois, et chaque autre point d'entrée du portail répond pour UNE SEULE marque sélectionnée (brand_id), jamais pour toutes à la fois.

L'adresse complète est https://api.sealtrust.io/v1/distributor-portal/brands. La même route existe sans le préfixe /v1.

#Autorisation

Session d'un compte contact distributeur. Voir GET /distributor-portal/me pour le détail des règles de session et des refus 401/403.

#Plafond d'appels

30 appels par minute, partagé avec le reste du portail distributeur.

#Requête d'exemple

curl
curl -i https://api.sealtrust.io/v1/distributor-portal/brands \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"

#Réponse d'exemple

JSON
[
  {
    "brand_id": 42,
    "brand_code": "7K3QXW9M2A",
    "brand_name": "Exemple SAS",
    "retailer_id": 9,
    "retailer_code": "DIST-DE",
    "retailer_name": "Distribution Exemple GmbH",
    "territory_countries": ["DE", "AT"],
    "alerts_opt_in": false
  },
  {
    "brand_id": 57,
    "brand_code": "9PQ2WZ4KXR",
    "brand_name": "Autre Marque SAS",
    "retailer_id": 31,
    "retailer_code": "DIST-OM-DE",
    "retailer_name": "Distribution Exemple GmbH (Autre Marque)",
    "territory_countries": ["DE"],
    "alerts_opt_in": true
  }
]

#Les champs de la réponse

ChampTypeDescription
brand_idintegerIdentifiant de la marque — à passer en brand_id aux autres appels du portail.
retailer_idintegerVotre distributeur chez cette marque.
territory_countriesarray ou nullTerritoire contractuel exclusif chez cette marque.
alerts_opt_inbooleanCette marque a activé pour vous la vue GET /distributor-portal/out-of-territory.

Une liste vide n'arrive jamais pour un appel autorisé qui aboutit : un compte sans aucun contact actif reçoit un 403, pas une liste vide (voir ci-dessous).

#Erreurs

CodeConditionQue faire
401Jeton absent, illisible ou expiré.Reconnectez-vous.
403Aucune ligne de contact active pour ce compte, à aucune marque. Message No active distributor access.Demandez à une marque de vous inviter.
429Plafond d'appels dépassé.Attendez le délai de Retry-After.

#Voir aussi

Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.

Proposer une correctionSignaler un problème