Jeux Indé

Entwickler-API

Mit der API belohnst du Spieler, die abstimmen, und zeigst deinen Platz an. Erstelle einen Schlüssel im Entwicklerbereich und rufe sie von deinem Server aus auf: Ein im Browser sichtbarer Schlüssel kann gestohlen werden.

Authentifizierung: Header Authorization: Bearer ji_… bei jeder Anfrage.

Hat ein Spieler abgestimmt?

Liefert die letzte Stimme der vergangenen 1 h 30, nach Benutzername (auf der Abstimmungsseite eingegeben) oder nach IP-Adresse.

curl "https://jeux-inde.com/api/v1/votes?pseudo=Itachi" \
  -H "Authorization: Bearer ji_xxx"

{"voted":true,"voted_at":"2026-10-27T14:02:11.000Z","next_vote_at":"2026-10-27T22:02:11.000Z"}

Platz in der Kategorie und Stimmen

curl "https://jeux-inde.com/api/v1/jeu" -H "Authorization: Bearer ji_xxx"

{"slug":"mon-jeu","title":"Mon jeu","genre":"mmorpg","universe":"dofus","genre_rank":1,"votes_month":312,"votes_total":2950}

Punktestände der Spieler senden

Nur der beste Punktestand jedes Spielers wird gespeichert. Die Punktestände erscheinen auf deiner Seite und in den Bestenlisten.

curl -X POST "https://jeux-inde.com/api/partner/scores" \
  -H "Authorization: Bearer ji_xxx" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"123","player_name":"Itachi","score":4200}'

{"ok":true,"best":4200,"record":true}

Abstimmungs-Webhook

Bei jeder Stimme geht eine POST-Anfrage an die im Entwicklerbereich eingestellte Adresse (höchstens 5 s Timeout, kein erneuter Versuch):

POST https://mon-jeu.fr/api/vote
Content-Type: application/json
X-JeuxInde-Signature: sha256=<HMAC-SHA256 des Bodys mit deinem Secret, hexadezimal>

{"event":"vote","game":"mon-jeu","pseudo":"Itachi","voted_at":"2026-10-27T14:02:11.000Z","votes_month":313}

Prüfe immer die Signatur, bevor du eine Belohnung vergibst. Beispiel in Node.js:

import { createHmac, timingSafeEqual } from "node:crypto";

const expected = "sha256=" + createHmac("sha256", process.env.JEUX_INDE_SECRET).update(rawBody).digest("hex");
const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));

Banner

SVG-Bild, alle 10 Minuten aktualisiert, mit deinem Platz in der Kategorie und deinen Stimmen des Monats. Den fertigen HTML-Code findest du im Entwicklerbereich.

<a href="https://jeux-inde.com/jeux/mon-jeu/voter">
  <img src="https://jeux-inde.com/api/widget/mon-jeu" width="320" height="64" alt="Voter pour Mon jeu">
</a>

Fehlercodes

  • 401 : Schlüssel fehlt oder ist ungültig.
  • 400 : Parameter fehlt (die Meldung sagt, welcher).
  • 503 : Dienst vorübergehend nicht verfügbar.