BXWY Logo

Connectez l'API, affichez votre badge

Branchez et jouez avec l'API et obtenez le code d'implémentation pour votre plateforme. Choisissez votre format, votre langue et la dimension du badge.

Essayez par vous-même

Sélectionnez n'importe quelle plateforme, choisissez votre format préféré et les dimensions du badge, puis copiez le code à intégrer sur votre site.

No badges available yet to preview

Comment implémenter l'API ?

1. Utilisez le testeur d'API ci-dessus pour générer votre code d'intégration

1.1 Sélectionnez votre plateforme

Choisissez votre entreprise dans la liste déroulante. Votre entreprise n'est pas visible ?

1.2 Choisissez votre format

Choisissez entre HTML, React ou le format API direct en fonction de vos besoins d'implémentation.

1.3 Sélectionnez la langue

Choisissez parmi l'anglais, le néerlandais, l'allemand, l'espagnol ou le français pour le texte de votre badge.

1.4 Choisissez les dimensions du badge

Sélectionnez 16:9 (paysage), 1:1 (carré) ou 5:1 (ultra large) selon l'endroit où vous l'afficherez.

* L'outil génère du code prêt à l'emploi que vous pouvez copier en un seul clic.

2. Collez le code dans votre site web

Ajoutez le code HTML/React généré à votre site web où vous souhaitez que le badge apparaisse, généralement dans votre en-tête, pied de page ou page À propos. Le badge renvoie automatiquement vers votre profil BuyXWithY.

3. Le badge se met à jour automatiquement toutes les 24 heures

Au fur et à mesure que les clients votent pour vos points forts, votre badge se met à jour quotidiennement (00:00:00 UTC+1) pour refléter votre principal avantage concurrentiel. Aucun changement de code nécessaire, l'API fournit automatiquement les dernières données du badge.

Testez l'API de badge comme un client

Essayez notre environnement de test complet pour voir les réponses API en direct, tester toutes les variations de badges et vérifier le code d'intégration avant la mise en ligne.

Ouvrir l'environnement de test

Référence API

Notre API de badge fournit deux points de terminaison : (1) l'un renvoie les données du badge de votre plateforme en JSON (pour des implémentations personnalisées), et un autre (2) fournit un badge image SVG prêt à l'emploi. Les deux sont complètement ouverts et ne nécessitent aucune authentification, utilisez simplement le slug d'URL de votre plateforme pour accéder instantanément aux données de votre badge ou à l'image.

1. Obtenir les données du badge

GET https://www.buyxwithy.com/api/badges/[platform-slug]

Renvoie des données JSON sur le badge d'une plateforme, y compris le type de badge, le nombre de votes et le pourcentage.

// Example Response
{
  "success": true,
  "platform": {
    "slug": "kraken",
    "name": "Kraken"
  },
  "badge": {
    "type": "Best Security",
    "voteCount": 342,
    "percentage": 67.5,
    "totalVotes": 506,
    "lastUpdated": "2025-10-25T12:00:00Z"
  }
}

2. Obtenir l'intégration du badge

GET https://www.buyxwithy.com/api/badges/[platform-slug]/embed

Renvoie un badge intégrable (SVG) que vous pouvez afficher sur votre site web.

Paramètres de requête :

  • format - Format du badge (svg, html, json)
  • lang - Code de langue (en, nl, de, es, fr)
  • dimension - Rapport d'aspect du badge (16:9, 1:1, 5:1)

Dimensions du badge

16:9 - Paysage
Idéal pour les barres latérales et les pieds de page
16:9 badge example
1:1 - Carré
Parfait pour les barres latérales et les pieds de page
1:1 badge example
5:1 - Ultra Large
Idéal pour les placements larges
5:1 badge example

Langues supportées

EN
English
NL
Nederlands
DE
Deutsch
ES
Español
FR
Français

Prêt à commencer ?

Rejoignez le programme de partenariat et commencez à mettre en valeur votre avantage concurrentiel.

S'inscrire au programme partenaire
Badge API - Partner Program - BuyXWithY