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 -i https://api.sealtrust.io/v1/distributor-portal/brands \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"#Réponse d'exemple
[
{
"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
| Champ | Type | Description |
|---|---|---|
brand_id | integer | Identifiant de la marque — à passer en brand_id aux autres appels du portail. |
retailer_id | integer | Votre distributeur chez cette marque. |
territory_countries | array ou null | Territoire contractuel exclusif chez cette marque. |
alerts_opt_in | boolean | Cette 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
| Code | Condition | Que faire |
|---|---|---|
| 401 | Jeton absent, illisible ou expiré. | Reconnectez-vous. |
| 403 | Aucune ligne de contact active pour ce compte, à aucune marque. Message No active distributor access. | Demandez à une marque de vous inviter. |
| 429 | Plafond d'appels dépassé. | Attendez le délai de Retry-After. |
#Voir aussi
GET /distributor-portal/me, le profil de la marque sélectionnée.GET /distributor-portal/shipments, les expéditions de la marque sélectionnée.
Cette page vous a-t-elle été utile ?
Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.