Jeux Indé

API créateurs

L'API sert à récompenser les joueurs qui votent et à afficher ta position. Génère une clé dans l'espace créateur et appelle-la depuis ton serveur : une clé visible dans le navigateur peut être volée.

Authentification : en-tête Authorization: Bearer ji_… sur chaque requête.

Un joueur a-t-il voté ?

Renvoie le dernier vote des dernières 1 h 30, par pseudo (saisi sur la page de vote) ou par adresse IP.

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"}

Position dans la catégorie et votes

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}

Envoyer les scores des joueurs

Seul le meilleur score de chaque joueur est conservé. Les scores apparaissent sur ta fiche et dans les classements.

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}

Webhook de vote

À chaque vote, une requête POST part vers l'adresse configurée dans l'espace créateur (5 s de délai maximum, pas de nouvel essai) :

POST https://mon-jeu.fr/api/vote
Content-Type: application/json
X-JeuxInde-Signature: sha256=<HMAC-SHA256 du corps avec ton secret, en hexadécimal>

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

Vérifie toujours la signature avant de distribuer une récompense. Exemple en 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));

Bannière

Image SVG mise à jour toutes les 10 minutes, avec ta position dans ta catégorie et tes votes du mois. Le code HTML prêt à coller est dans l'espace créateur.

<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>

Codes d'erreur

  • 401 : clé manquante ou invalide.
  • 400 : paramètre manquant (le message précise lequel).
  • 503 : service momentanément indisponible.