BXWY Logo

Verbinde die API, zeige dein Badge

Steck die API einfach rein und erhalte Implementierungscode für deine Plattform. Wähle dein Format, deine Sprache und die Badge-Dimension.

Probiere es selbst aus

Wähle eine beliebige Plattform, dein bevorzugtes Format und die Badge-Dimensionen, kopiere dann den Code zum Einbetten auf deiner Website.

No badges available yet to preview

Wie implementiere ich die API?

1. Verwende den API-Tester oben, um deinen Einbettungscode zu generieren

1.1 Wähle deine Plattform

Wähle dein Unternehmen aus der Dropdown-Liste. Dein Unternehmen nicht sichtbar?

1.2 Wähle dein Format

Wähle zwischen HTML, React oder direktem API-Format basierend auf deinen Implementierungsbedürfnissen.

1.3 Sprache auswählen

Wähle aus Englisch, Niederländisch, Deutsch, Spanisch oder Französisch für deinen Badge-Text.

1.4 Badge-Dimensionen auswählen

Wähle 16:9 (Querformat), 1:1 (Quadrat) oder 5:1 (Ultra Wide) basierend darauf, wo du es anzeigen möchtest.

* Das Tool generiert sofort verwendbaren Code, den du mit einem Klick kopieren kannst.

2. Füge den Code in deine Website ein

Füge den generierten HTML/React-Code in deine Website ein, wo das Badge erscheinen soll, typischerweise in deiner Kopfzeile, Fußzeile oder About-Seite. Das Badge verlinkt automatisch zurück zu deinem BuyXWithY-Profil.

3. Badge aktualisiert sich automatisch alle 24 Stunden

Wenn Kunden für deine Stärken abstimmen, aktualisiert sich dein Badge täglich (00:00:00 UTC+1), um deinen wichtigsten Wettbewerbsvorteil widerzuspiegeln. Keine Code-Änderungen nötig, die API liefert die neuesten Badge-Daten automatisch.

Teste die Badge-API wie ein Kunde

Probiere unsere umfassende Testumgebung aus, um Live-API-Antworten zu sehen, alle Badge-Variationen zu testen und den Integrationscode vor dem Livegang zu überprüfen.

Testumgebung öffnen

API-Referenz

Unsere Badge-API bietet zwei Endpunkte: (1) einer gibt die Badge-Daten deiner Plattform als JSON zurück (für individuelle Implementierungen), und ein anderer (2) liefert ein sofort verwendbares SVG-Bild-Badge. Beide sind vollständig offen und erfordern keine Authentifizierung, verwende einfach den URL-Slug deiner Plattform, um sofort auf deine Badge-Daten oder das Bild zuzugreifen.

1. Badge-Daten abrufen

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

Gibt JSON-Daten über das Badge einer Plattform zurück, einschließlich Badge-Typ, Stimmenanzahl und Prozentsatz.

// 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. Badge-Einbettung abrufen

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

Gibt ein einbettbares Badge (SVG) zurück, das du auf deiner Website anzeigen kannst.

Abfrageparameter:

  • format - Badge-Format (svg, html, json)
  • lang - Sprachcode (en, nl, de, es, fr)
  • dimension - Badge-Seitenverhältnis (16:9, 1:1, 5:1)

Badge-Dimensionen

16:9 - Querformat
Ideal für Seitenleisten und Fußzeilen
16:9 badge example
1:1 - Quadrat
Perfekt für Seitenleisten und Fußzeilen
1:1 badge example
5:1 - Ultra Wide
Ideal für breite Platzierungen
5:1 badge example

Unterstützte Sprachen

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

Bereit loszulegen?

Tritt dem Partnerprogramm bei und beginne, deinen Wettbewerbsvorteil zu präsentieren.

Für das Partnerprogramm anmelden
Badge API - Partner Program - BuyXWithY