Intégrez Pimelo à vos outils e-commerce grâce à notre API REST. Gérez vos produits, entités, attributs et médias par programmation.
Inscrivez-vous gratuitement sur Pimelo et accédez à votre tableau de bord.
Rendez-vous dans Paramètres > Tokens API pour créer votre clé d'accès avec les scopes souhaités.
Utilisez votre token Bearer pour interroger l'API. Testez avec l'endpoint /channels ci-dessous.
# Lister vos canaux de vente
curl -X GET https://www.pimelo.app/api/v1/channels \
-H "Authorization: Bearer pim_your_token_here" \
-H "Content-Type: application/json"
Toutes les requêtes API nécessitent un token Bearer. Incluez-le dans le header Authorization de chaque requête.
Authorization: Bearer pim_xxxxxxxxxxxxxxxx
Les tokens API commencent par le préfixe pim_ suivi d'une chaîne aléatoire. Chaque token est lié à un utilisateur et à une organisation avec des scopes spécifiques.
| Scope | Description |
|---|---|
| products:read | Lire les produits et leurs valeurs |
| products:write | Créer et modifier des produits |
| entities:read | Lire les entités et leurs valeurs |
| entities:write | Créer et modifier des entités |
| settings:read | Lire la configuration (canaux, locales) |
| settings:write | Modifier la configuration |
| media:read | Télécharger et consulter les médias |
| media:write | Uploader et gérer les médias |
| import-export:read | Lire les profils et tâches d'import/export |
| import-export:write | Lancer des imports et exports |
| attributes:read | Lire les attributs et jeux d'attributs |
| attributes:write | Créer et modifier les attributs |
Toutes les requêtes API utilisent le même préfixe de base. Les réponses sont au format JSON.
https://www.pimelo.app/api/v1/
Les listes de résultats utilisent une pagination par curseur (search_after). Chaque réponse inclut un curseur pour la page suivante.
Les endpoints de recherche acceptent un objet JSON avec des filtres sur les attributs, le statut, le canal et la locale.
Les erreurs suivent le format RFC 7807 (Problem Details) avec un code HTTP, un type et un message descriptif.
600 requêtes par minute par token. Les headers X-RateLimit-Limit, X-RateLimit-Remaining et Retry-After sont inclus dans chaque réponse.
Explorez les endpoints disponibles pour gérer vos données produit.
Connectez Claude, ChatGPT ou tout agent IA à Pimelo via le Model Context Protocol. 14 outils pour rechercher, créer et mettre à jour vos données produit en langage naturel.
Documentation interactive avec exemples de requêtes, réponses et possibilité de tester en direct.
Ouvrir la référence API