Aller au contenu principal
Plytix

Plytix API depuis Odoo : clé, mot de passe, jeton et limites d'appels

Pour parler à l'API de Plytix, il faut une clé d'API et son mot de passe, un jeton qui expire au bout de 900 secondes, et il faut respecter deux limites d'appels en même temps. Le connecteur Plytix pour Odoo le fait pour vous via FlexigoTech Cloud. Voici ce que demande l'API et comment cela se présente dans Odoo.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 14 novembre 2026

L'essentiel

Module
Plytix
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
5 min

La clé et le mot de passe de l'API de Plytix

Dans Plytix, la clé se crée dans Account, puis API, puis API Keys. Seuls les utilisateurs Owner et Admin peuvent en créer une. Chaque clé arrive avec un mot de passe que Plytix affiche à côté. L'API a besoin des deux.

Dans Odoo, vous les collez dans Plytix › Configuration › Comptes Plytix, dans les champs Clé d'API et Mot de passe d'API. Les deux vont ensemble ou rien ne part : s'il en manque un, le connecteur n'envoie rien. Avant de les enregistrer, un administrateur doit accepter que FlexigoTech Cloud les conserve.

Tableau de bord du connecteur Plytix dans Odoo
Plytix dans Odoo : le compte connecté et les quatre étapes de mise en route (données de démonstration).

Le jeton qui dure 900 secondes

L'API de Plytix s'authentifie en deux temps. D'abord, la paire clé et mot de passe s'échange contre un jeton auprès du service d'authentification de Plytix. Ce jeton dure exactement 900 secondes. Ensuite, chaque appel porte le jeton.

Si vous intégrez Plytix vous-même, vous devez stocker la paire, demander le jeton et le renouveler avant son expiration. Avec le connecteur, c'est FlexigoTech Cloud qui s'en occupe. Il garde la paire chiffrée, demande le jeton, le renouvelle et l'ajoute à chaque appel. Odoo ne garde ni la paire ni le jeton.

Deux limites d'appels en même temps

Plytix limite les appels avec deux compteurs à la fois : un par tranche de 10 secondes et un par heure. Les deux dépendent de votre formule. Le connecteur ralentit avant d'envoyer pour ne pas les dépasser. S'il les dépasse malgré tout, Plytix répond par un 429 qui indique combien de temps attendre (en-tête Retry-After) et quelle est la limite (RateLimit-Limit et RateLimit-Window).

La page des tarifs de Plytix (www.plytix.com/pricing, consultée le 12 novembre 2026) donne 2 000 appels par heure à la formule Standard, 15 000 à Pro et 25 000 à Enterprise. Standard n'est gratuite que jusqu'à 100 SKU ; au-delà, elle est payante. La documentation de son API ajoute que les limites dépendent de la formule et que votre gestionnaire de compte vous confirme celles de votre compte.

Sur le compte Odoo, vous choisissez votre formule dans le champ Formule, et le connecteur remplit les deux limites :

  • Standard : 20 appels toutes les 10 secondes et 2 000 par heure.
  • Pro : 50 appels toutes les 10 secondes et 15 000 par heure.
  • Enterprise : 50 appels toutes les 10 secondes et 25 000 par heure.
  • Limites personnalisées : elles partent de 20 et 2 000, et vous les saisissez.

Ce sont les chiffres de la version 1.3.0 du connecteur ; les chiffres horaires viennent de la page des tarifs de Plytix. Lors de la mise à jour, un compte resté sur les chiffres précédents (Standard, 5 000 par heure ; Enterprise, 15 000) passe de lui-même aux nouveaux, et un compte dont quelqu'un a modifié les limites reste tel quel. Les deux champs de limites se modifient à la main et n'acceptent pas moins de 1 appel. Si un 429 arrive, le connecteur enregistre sur le compte la limite indiquée par Plytix et attend le temps demandé : jusqu'à 15 secondes, dans le même appel ; si l'attente est plus longue, il met la synchronisation en pause, sans rien marquer en échec, et ce qui reste part ensuite.

Recherches : 20 attributs et 100 résultats par page

Les recherches de l'API de Plytix renvoient peu de champs par défaut. Il faut demander chaque attribut par son nom, et Plytix en accepte au plus 20 par recherche. S'il vous en faut plus, le connecteur fait plusieurs passages et les fusionne sur l'identifiant du produit. Chaque page apporte au plus 100 résultats. Au-delà, l'API répond par une erreur 422.

Ce que fait le connecteur avec l'API

Le connecteur rapproche les produits, variantes et sous-variantes par SKU. Si le SKU n'identifie pas l'enregistrement, il ne crée pas le rapprochement. Vous le trouvez dans Plytix › Produits › Rapprocher par SKU, et l'import dans Plytix › Produits › Importer depuis Plytix.

Deux tâches planifiées suivent les changements : importer les produits modifiés toutes les 6 heures et les exporter toutes les 12 heures. Les deux sont désactivées au départ. Vous les activez après avoir vérifié la correspondance des champs et le sens de chaque synchronisation.

Liste des produits liés à Plytix dans Odoo
Produits liés : ce qui vient de Plytix et si c'est à jour (données de démonstration).

Ce qu'il vous faut

Il vous faut un compte Plytix actif avec sa clé d'API. Le connecteur est sur Odoo Apps pour Odoo 17, 18, 19 et 20 et il a besoin de l'abonnement FlexigoTech Cloud. Tous les détails sont sur la page du connecteur.

Où se trouve la documentation de l'API de Plytix ?

Sur apidocs.plytix.com. Le connecteur travaille avec l'API REST de Plytix en HTTPS.

Que se passe-t-il si Plytix répond par un 429 ?

Le connecteur ralentit avant d'envoyer, selon les limites du compte. Si un 429 arrive quand même, il enregistre la limite indiquée par Plytix et attend le temps demandé, jusqu'à 15 secondes dans le même appel. Si l'attente est plus longue, la synchronisation se met en pause sans rien marquer en échec, et ce qui reste part quand Plytix le permet.

Puis-je utiliser l'offre gratuite de Plytix ?

Oui, si vous gérez jusqu'à 100 SKU : c'est ce que Plytix donne gratuitement avec Standard, selon sa page des tarifs. Sur le compte, vous choisissez Standard et le connecteur part de 20 appels toutes les 10 secondes et de 2 000 par heure. Le connecteur a quand même besoin de l'abonnement FlexigoTech Cloud.

Odoo garde-t-il ma clé Plytix ?

Non. La clé et le mot de passe sont gardés par FlexigoTech Cloud, chiffrés, après le consentement d'un administrateur.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): __manifest__.py
  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): static/description/index.html
  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): models/plytix_account.py
  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): data/plytix_cron_data.xml
  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): views/plytix_menus.xml
  • Code du module : flexigobe_plytix_connector 20.0 (6d411531): models/plytix_api_client.py
  • www.plytix.com/pricing/
  • docs.plytix.com/reference/v1-v2/rate-limits/
  • Code du module : flexigobe_plytix_connector 20.0 (40f61773): models/plytix_account.py
  • Code du module : flexigobe_plytix_connector 20.0 (40f61773): migrations/1.3.0/post-migrate.py
  • Code du module : flexigobe_plytix_connector 20.0 (40f61773): models/plytix_api_client.py