Comment relier les services d'un fournisseur aux fiches du panneau SMM via l'API
Pourquoi séparer le catalogue du fournisseur de la vitrine du panneau
L'API du fournisseur renvoie généralement un catalogue technique : ID externe, nom, prix, limites, statut et paramètres de commande. Dans le panneau SMM, la même position doit s'intégrer dans une structure compréhensible pour le client : plateforme, type de promotion, géographie, format du lien, qualité de l'audience ou vitesse de lancement.
Si vous affichez le catalogue externe sans traitement, des noms techniques, des doublons et des positions indisponibles apparaîtront dans la vitrine. Le mappage sépare la logique d'achat de la fiche client. Un service du fournisseur ne doit pas forcément correspondre à un service distinct dans le panneau.
Quelles données récupérer via l'API
Conservez les données brutes du fournisseur séparément des paramètres de la vitrine. L'ID externe ne doit pas être remplacé par l'identifiant interne du panneau : il est nécessaire pour créer une commande, obtenir un statut, annuler et analyser les erreurs. Il est également utile de stocker l'heure de la dernière synchronisation et la réponse complète de l'API ou un instantané de celle-ci.
- Identifiant du fournisseur et ID externe du service.
- Nom, description et catégorie externe.
- Prix d'achat, devise et unité de calcul.
- Volume minimum, maximum et pas de quantité.
- Statut de disponibilité, stock restant et indicateur d'arrêt temporaire.
- Exigences concernant le lien, l'identifiant, la publication, le commentaire et la géographie.
- Indicateurs de lancement manuel, d'annulation, de relance et d'exécution partielle.
L'inconvénient de l'import automatique est que les fournisseurs nomment différemment les mêmes champs et transmettent parfois des données incomplètes. Le nom du service ne convient pas pour une liaison stable : il peut être modifié sans changement de l'ID externe.
Exemple de requête et de réponse du catalogue de services
Le format de l'API dépend du fournisseur, mais la logique est généralement la même : le panneau transmet la clé d'accès et les paramètres de page, puis reçoit en réponse un tableau de services. Par exemple, une requête de catalogue avec curseur peut ressembler à ceci :
GET /api/services?cursor=eyJwYWdlIjoyfQ
Réponse API conditionnelle :
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Il ne faut pas écrire immédiatement les champs de la réponse dans la fiche de la vitrine. Il faut d'abord les vérifier, les enregistrer dans le catalogue du fournisseur et les associer aux règles internes. L'inconvénient de travailler uniquement avec une fiche prête est que l'import peut écraser le nom client, la description ou la catégorie choisie manuellement.
Définissez d'abord la structure des catégories dans le panneau
Avant l'import, définissez la taxonomie du panneau. Le niveau supérieur décrit généralement la plateforme, le suivant — l'action : abonnés, vues, réactions, commentaires, spectateurs de diffusion ou autre format. À l'intérieur, vous pouvez diviser les services par géographie, type d'audience, vitesse et conditions de compensation.
Pour chaque catégorie, définissez les attributs obligatoires. Pour les vues, il peut s'agir du type de lien et du format du contenu ; pour les abonnés — de la plateforme, de la géographie et du type de profil autorisé. L'inconvénient d'une structure trop détaillée est que le catalogue devient plus difficile à maintenir et que des services proches commencent à ne différer que par des nuances internes.
Stockez séparément les liens entre le fournisseur et la vitrine
La liaison entre le service du fournisseur et la fiche du panneau doit être stockée dans une table ou une entité distincte. Elle doit contenir le fournisseur, l'ID externe, la fiche interne, la catégorie, la règle de prix, la priorité de routage, le statut de publication et la date de la dernière vérification réussie.
Ce schéma permet de remplacer le fournisseur sans changer l'URL de la fiche et sans perdre l'historique des commandes. Exemple de ligne de mappage en JSON :
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Les liaisons peuvent être différentes, mais définissez à l'avance une règle de mise à jour pour chacune.
- Un service du fournisseur — une fiche, s'il a des paramètres et un formulaire de commande uniques.
- Plusieurs services de fournisseurs différents — une fiche, s'ils sont compatibles en termes d'exigences et de conditions.
- Un service du fournisseur — plusieurs fiches, si la vitrine le divise par langue, segment ou mode de vente.
Le regroupement de plusieurs fournisseurs dans une même fiche présente un inconvénient : la vitesse, la disponibilité et les conditions réelles d'exécution peuvent différer. Ne regroupez pas des routes avec des formats de lien, des limites ou des champs obligatoires différents.
Importez le catalogue page par page
Le fournisseur peut renvoyer le catalogue par pages via un numéro, un décalage ou un curseur. La première réponse ne contient pas forcément tous les services. Demandez la page suivante tant que l'API transmet un curseur, un lien de continuation ou un autre indicateur explicite de présence de données.
Avec la pagination par curseur, le traitement se déroule ainsi : le panneau reçoit une page, enregistre tous les services, les marque comme trouvés dans le cycle en cours, puis passe seulement ensuite au curseur suivant. Si le champ next_cursor est absent, le parcours est considéré comme terminé.
- Créez un identifiant pour le cycle de synchronisation en cours.
- Demandez la première page et enregistrez les services reçus.
- Pour chaque service, mettez à jour le champ last_seen_sync avec l'identifiant du cycle.
- Enregistrez le curseur de la page suivante avant d'exécuter la requête suivante.
- Après avoir parcouru toutes les pages avec succès, comparez le catalogue avec le cycle en cours.
L'inconvénient du chargement séquentiel des pages est que l'import complet peut prendre plus de temps. Les requêtes parallèles accélèrent le processus, mais augmentent le risque de se heurter à la limite de l'API ou d'obtenir des pages dans des états différents du catalogue.
Ne créez pas de doublons lors d'une nouvelle synchronisation
Pour rechercher un service existant, utilisez une clé composite : identifiant du fournisseur et ID externe du service. À chaque nouvel import, recherchez d'abord l'enregistrement par cette paire, puis mettez à jour les champs techniques. Ne créez un nouvel enregistrement qu'en l'absence d'une telle clé.
N'utilisez pas le nom, le prix ou la catégorie pour la déduplication. Deux services différents peuvent avoir ces valeurs identiques, et le fournisseur peut renommer une position sans changer l'ID externe. Pour les liaisons avec la vitrine, un contrôle d'unicité est également nécessaire : une même route ne doit pas apparaître deux fois après une relance de la tâche.
Il est utile de limiter l'unicité au niveau de la base de données : supplier_id + external_service_id pour le catalogue du fournisseur et supplier_id + external_service_id + showcase_card_id pour le mappage. L'inconvénient d'une contrainte stricte est qu'en cas d'erreur dans une ancienne liaison, il faudra la corriger explicitement plutôt que de créer un nouvel enregistrement par-dessus.
Comment détecter les services supprimés et disparus
Un service ne peut être considéré comme disparu qu'après un parcours entièrement réussi de toutes les pages. Si la synchronisation s'est arrêtée sur une erreur, une limite de requêtes ou une indisponibilité de l'API, les positions absentes de la partie déjà chargée du catalogue ne doivent pas être marquées comme supprimées.
Après un import terminé, recherchez les services de ce fournisseur dont last_seen_sync n'est pas égal à l'identifiant du cycle en cours. Ils reçoivent le statut « introuvable » ou « archivé », sont désactivés pour les nouvelles commandes et envoyés en vérification. L'ID externe, l'historique des modifications et les liaisons avec les commandes sont conservés.
Un service disparu doit être archivé, pas supprimé. Le fournisseur peut le réintégrer au catalogue plus tard, modifier le filtre de réponse ou masquer temporairement la position. La liaison archivée peut être restaurée lors du prochain import si le même ID externe réapparaît.
Que faire en cas de changement de l'ID externe du service
Si le fournisseur a créé un nouveau service à la place de l'ancien, le nouvel ID externe ne peut pas être automatiquement considéré comme la continuation du précédent. Même avec un nom et un prix identiques, les exigences de commande, la géographie, le type d'audience ou les conditions de compensation de la position peuvent avoir changé.
Placez l'ancienne liaison en archive, retirez la route de la vente et conservez-la pour les anciennes commandes. Importez le nouveau service comme un enregistrement distinct. Créez ensuite un nouveau mappage manuellement ou selon une règle sûre, si les paramètres techniques sont entièrement compatibles.
La correspondance automatique par nom peut accélérer le travail, mais son inconvénient est le risque d'envoyer une commande vers un autre service aux conditions inadaptées. Pour un changement d'ID, il vaut mieux utiliser le statut « nécessite une vérification » plutôt qu'un remplacement silencieux de la route.
Configurez le mappage selon des champs techniques stables
Il est préférable de construire la répartition automatique des services sur un ensemble de champs : plateforme, type de service, géographie, format du lien, volume minimum, paramètres supplémentaires et statut. Par exemple, un service peut être classé dans la catégorie des vues par géo si l'API transmet des valeurs compatibles de plateforme, de type de promotion et de pays.
Si le fournisseur exige un commentaire, une liste de profils ou un lancement manuel, ne publiez pas la route dans le formulaire de commande standard. Utilisez une fiche distincte avec les champs nécessaires ou laissez le service masqué jusqu'à l'aboutissement de l'intégration.
Le nom ne peut être utilisé que comme attribut supplémentaire. L'inconvénient d'une telle règle est que le fournisseur peut modifier la formulation, ajouter une abréviation ou utiliser une autre orthographe. Liez les routes critiques à l'ID externe et aux paramètres vérifiables de la réponse.
Séparez les données de l'API et les paramètres de la fiche
L'import ne doit pas entièrement écraser la fiche de la vitrine. Le prix d'achat, les limites, la disponibilité et les paramètres techniques sont généralement mis à jour depuis le fournisseur. Le nom pour le client, la description, la visibilité, l'ordre d'affichage et les règles de majoration restent des paramètres internes du panneau.
Pour chaque champ, désignez la source de vérité. Par exemple, le volume minimum provient de l'API, le nom client — du panneau, et le prix de la vitrine est calculé selon une règle interne à partir du coût d'achat. Sans cette séparation, la synchronisation peut effacer une description modifiée manuellement ou changer la catégorie selon le nom externe.
Vérifiez les changements de prix et de paramètres
Si le fournisseur a modifié le prix, recalculez le prix de la vitrine selon la règle de la fiche et vérifiez la devise, les commissions et la marge autorisée. En cas de prix absent, de devise inconnue ou de changement notable des conditions, il vaut mieux placer la route en statut de vérification.
En cas de modification du minimum, du maximum ou du pas de quantité, mettez à jour le formulaire de commande. Si le formulaire ne prend pas en charge les nouvelles restrictions, retirez la route de la vente. Sinon, le client passera une commande que le fournisseur rejettera après l'envoi.
Si le format du lien, un champ obligatoire, le type de service ou le mode de lancement ont changé, bloquez les nouvelles commandes jusqu'à une vérification manuelle. L'inconvénient d'un blocage strict est que certaines fiches disparaîtront temporairement de la vitrine, mais c'est plus sûr que d'accepter des commandes incompatibles.
Gérez les erreurs de l'API et les limites de requêtes
Une erreur sur une seule requête ne doit pas désactiver automatiquement tout le catalogue. Distinguez les erreurs d'autorisation, de requête incorrecte, d'indisponibilité temporaire et de limitation de fréquence des requêtes. Chaque groupe nécessite un scénario distinct.
- En cas d'erreur d'autorisation, arrêtez les nouvelles commandes auprès de ce fournisseur et vérifiez l'accès.
- En cas d'erreur de format de requête, enregistrez la réponse de l'API et corrigez l'intégration sans répétitions infinies.
- En cas d'erreur temporaire, répétez la requête avec une pause croissante.
- En cas de limitation de fréquence, enregistrez le curseur actuel et reportez la tâche.
Ne marquez pas les services comme disparus tant que la synchronisation différée n'est pas terminée avec succès. L'inconvénient des répétitions agressives est que vous pouvez épuiser plus rapidement la limite de requêtes et laisser le catalogue obsolète plus longtemps.
Conservez les routes pour les commandes actives
Le statut du service et le statut de la commande sont des entités différentes. Un service peut disparaître du catalogue pour les nouveaux clients, mais les anciennes commandes correspondantes sont toujours en cours d'exécution. L'archivage d'une fiche ou d'une route ne doit pas arrêter l'interrogation des statuts des commandes déjà créées.
Pour chaque commande, conservez l'ID externe du service, l'ID externe de la commande, les paramètres envoyés, le coût d'achat au moment du lancement et l'historique des statuts. Si le fournisseur signale une exécution partielle, une annulation ou une erreur, traitez la situation selon les règles du panneau : remboursement, compensation, relance ou vérification manuelle.
L'inconvénient du stockage d'un instantané des paramètres de commande est qu'il nécessite plus d'espace et un schéma de données rigoureux. Sans un tel instantané, il est impossible d'établir à quelles conditions la commande a été envoyée si le fournisseur a modifié le service par la suite.
Testez le mappage avant de publier les fiches
Après la configuration, vérifiez le parcours complet : création d'une commande dans le panneau, sélection de la route, envoi au fournisseur, enregistrement de l'ID externe, réception du statut, annulation et traitement de l'exécution partielle. Testez des groupes de services avec des limites, des liens et des champs obligatoires différents.
Modélisez séparément un nouvel import, un changement de prix, la disparition d'un service après un parcours complet réussi, une erreur au milieu de la pagination et une limitation de fréquence des requêtes. Cela montrera si le panneau archive des routes actives en raison d'un chargement incomplet du catalogue.
Accordez une attention particulière aux services manuels et aux positions avec commentaires. Leur inconvénient est que le formulaire standard du panneau ne transmet souvent pas toutes les données attendues par le fournisseur. Ils nécessitent un modèle de commande distinct ou un statut masqué jusqu'à l'aboutissement de l'intégration API.
Last Articles
Ce qui a changé dans le design et les fonctionnalités Nous avons mis à jour le site pour que vous puissiez travailler plus rapidement et plus confort..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Utilisez le code promo "December2025" pour une remise de 15% pour tous nos viewers2. Nous avons réduit jusqu'au 1er janvier les prix de base de not..
Les services Twitch sont travaillant de manière stable, nous sommes donc prêts à coopérer avec des équipes, des revendeurs, propriétaires de servi..
Nous nous avons complètement mis à jour nos services de visionneuse Twitch, et ils sont maintenant fonctionne de manière stable. Nous n'utilisons ..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
En raison de l'énorme popularité des services de partenariat et du programme de parrainage, nous avons créé un tableau de coopération. L'essentiel est..
Nos Services pour les Streamers
Nos Services pour les Créateurs de Contenu










