Un client d’API envoie une requête à une API et affiche la réponse, sans une ligne de code. Postman est le plus répandu ; Insomnia, Bruno, Hoppscotch ou Thunder Client (dans VS Code) font la même chose, avec d’autres libellés. Les étapes ci-dessous utilisent Postman, qui n’existe qu’en anglais : ses libellés sont repris tels quels, dans leur version d’octobre 2026, et son interface change de temps en temps. Dans un autre client, cherchez les mêmes notions : la méthode, l’URL, l’authentification (Basic Auth) et le corps de la requête.

Préparer une collection

Dans Postman, une collection regroupe des requêtes. L’authentification se règle une fois sur elle, et chaque requête qu’on y ajoute l’utilise.

  1. Créez une nouvelle collection et choisissez Blank collection. Donnez-lui le nom de votre marketplace.
  2. Dans la collection, ouvrez l’onglet Authorization et choisissez le type Basic Auth.
  3. Saisissez votre clé d’API (pk_…) dans Username et votre secret API (sk_…) dans Password, puis enregistrez la collection.

Envoyer votre première requête

  1. Dans la collection, cliquez sur Add request (ou +).

  2. Laissez la méthode sur GET et saisissez l’URL d’une liste, par exemple les catégories de vos annonces :

    https://votre-marketplace.mykreezalid.com/api/v1/listings/categories

    Remplacez votre-marketplace.mykreezalid.com par le domaine principal de votre marketplace : son domaine personnalisé, s’il y en a un de connecté.

  3. Laissez l’onglet Authorization de la requête sur Inherit auth from parent : elle utilise celle de la collection.

  4. Cliquez sur Send.

La réponse s’affiche en dessous, en JSON : la liste de vos catégories, avec le statut 200 OK.

Lire les données d’un vendeur

Chaque utilisateur a un identifiant : le nombre à la fin de l’URL de son écran dans l’espace d’administration, par exemple …/admin/users/151155.

Dans une nouvelle requête GET de la même collection :

  • …/api/v1/users/151155 renvoie l’utilisateur, avec ses métadonnées ;
  • …/api/v1/users/151155/metafields renvoie seulement ses métadonnées.

Une métadonnée (metafield dans l’API) est une donnée à vous, enregistrée sur un utilisateur, une annonce ou une commande : un code dans votre outil comptable, un niveau, une référence. Chacune a un namespace (le groupe auquel elle appartient), un title (son nom) et une value (sa valeur) :

{
  "metafields": [
    { "namespace": "crm", "title": "account_code", "value": "V-0042" }
  ]
}

Modifier une métadonnée d’un vendeur

  1. Dans la même collection, ajoutez une requête et choisissez la méthode POST.

  2. Saisissez https://votre-marketplace.mykreezalid.com/api/v1/users/151155/metafields, avec votre domaine et l’identifiant du vendeur.

  3. Laissez son authentification sur Inherit auth from parent.

  4. Ouvrez l’onglet Body, choisissez raw, puis JSON dans la liste déroulante à droite.

  5. Collez la métadonnée :

    { "namespace": "crm", "title": "account_code", "value": "V-0043" }

  6. Cliquez sur Send.

La réponse reprend ce qui a été enregistré. Si l’utilisateur a déjà une métadonnée avec ce namespace et ce title, sa valeur est remplacée ; sinon, elle est créée. Renvoyez la requête GET pour vérifier.

Pour en enregistrer plusieurs d’un coup, envoyez une liste : [{ … }, { … }]. Pour les annonces et les commandes, l’URL devient …/listings/<identifiant>/metafields ou …/orders/<identifiant>/metafields. Le portail développeur détaille les metafields.

Ce que vos utilisateurs voient

Une requête GET ne change rien. Une requête POST, PUT ou DELETE modifie votre marketplace comme le ferait l’espace d’administration : une annonce créée par l’API est en ligne pour tout le monde, un utilisateur supprimé est supprimé. Les métadonnées sont renvoyées par l’API Front à l’utilisateur à qui elles appartiennent, et un thème peut les afficher : n’y mettez rien que cet utilisateur ne doive pas voir.

Cas particuliers et limites

  • De vraies données : Postman agit sur votre marketplace en ligne. Essayez vos requêtes POST sur un utilisateur ou une annonce de test.
  • Les valeurs sont du texte : envoyez "12" plutôt que 12. Une valeur "0" ou vide est refusée : utilisez "non" ou "-".
  • Pas de suppression : une métadonnée ne se supprime pas par l’API ; écrasez sa valeur à la place.
  • Votre thème peut lire certaines métadonnées : en modifier une peut changer ce qu’affiche la vitrine. Demandez à qui a construit le thème avant de toucher à un namespace que vous n’avez pas créé.
  • Les deux autres API : cet article ne traite que de l’API Admin. L’API Partners utilise aussi Basic Auth, avec les identifiants propres à un vendeur ; l’API Front utilise un jeton obtenu en se connectant. Voir Authentication sur le portail développeur.