Méthode GET/distributor-portal/me

Lire votre profil, votre distributeur et son territoire. Session de compte contact distributeur, aucun droit de clef d'API.

Sur cette page

Vous lisez votre profil de contact distributeur : le distributeur pour lequel vous travaillez et son territoire contractuel. C'est l'appel à faire au démarrage de votre intégration : il vous dit quel distributeur votre session atteint pour la marque sélectionnée, et la liste de toutes les marques pour lesquelles vous êtes un contact actif.

L'adresse complète est https://api.sealtrust.io/v1/distributor-portal/me. La même route existe sans le préfixe /v1, et c'est la forme /v1 qui est recommandée pour une nouvelle intégration.

#Autorisation

Session d'un compte contact distributeur. Aucun droit de clef d'API n'intervient ici.

Le compte doit avoir le rôle distributor. Un compte client, un compte partenaire (réparateur, recycleur) ou un compte d'équipe de marque reçoit un 403, avec le message Distributor contact account required.

FaçonQuand l'utiliser
En-tête Authorization: Bearer <jeton>Appel de serveur à serveur, script.
Cookie de session access_tokenNavigateur, une fois connecté au portail.

Vous obtenez un jeton en appelant POST /v1/auth/login avec username et password, comme pour tout autre compte.

#Paramètres de requête

ParamètreTypeDescription
brand_idintegerLa marque à décrire. Omis : la seule marque accessible s'il n'y en a qu'une (comportement historique, inchangé) ; sinon la première par ordre alphabétique — appelez GET /distributor-portal/brands pour la liste complète et laisser la personne choisir.

#Plafond d'appels

30 appels par minute, le même plafond et le même rythme humain que le portail partenaire : vous consultez vos expéditions puis confirmez une réception. Il couvre l'ensemble du portail distributeur ; alterner entre les points d'entrée ne redonne donc pas de marge. Au-delà, l'API répond 429 avec un en-tête Retry-After.

#Requête d'exemple

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

#Réponse d'exemple

JSON
{
  "id": 214,
  "email": "contact@distributeur-exemple.test",
  "name": "Camille Exemple",
  "retailer_id": 9,
  "retailer_code": "DIST-DE",
  "retailer_name": "Distribution Exemple GmbH",
  "brand_id": 42,
  "brand_code": "7K3QXW9M2A",
  "brand_name": "Exemple SAS",
  "territory_countries": ["DE", "AT"],
  "brands": [
    {
      "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
retailer_idintegerIdentifiant de votre distributeur POUR LA MARQUE SÉLECTIONNÉE (brand_id).
retailer_codestringCode du distributeur chez cette marque.
territory_countriesarray ou nullCodes ISO2 du territoire contractuel exclusif, pour cette marque. null ou vide : votre distributeur n'a pas de territoire propre, les pays autorisés de la marque s'appliquent.
brandsarrayToutes les marques pour lesquelles vous êtes un contact ACTIF — un sélecteur, jamais une liste à fusionner. Un seul élément : rien à choisir, c'est le comportement historique. alerts_opt_in dit si la marque a activé la vue hors territoire pour vous (GET /distributor-portal/out-of-territory).

#Erreurs

CodeConditionQue faire
401Jeton absent, illisible ou expiré.Reconnectez-vous, puis rappelez avec Authorization: Bearer <jeton>.
403Le compte n'a pas le rôle distributor. Message Distributor contact account required.Demandez un compte de contact distributeur à la marque.
403Le contact a été révoqué partout : aucune ligne active ne reste pour ce compte, à aucune marque. Message No active distributor access.Demandez à une marque de vous inviter à nouveau.
404brand_id donné, mais sans contact actif pour cette marque (y compris une marque qui n'existe pas). Même réponse dans les deux cas.Vérifiez l'identifiant, ou appelez sans brand_id / via GET /distributor-portal/brands pour voir les marques réellement accessibles.
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