Jeux Indé

API para creadores

La API sirve para recompensar a los jugadores que votan y mostrar tu posición. Genera una clave en el espacio del creador y llámala desde tu servidor : una clave visible en el navegador puede ser robada.

Autenticación: cabecera Authorization: Bearer ji_… en cada petición.

¿Ha votado un jugador?

Devuelve el último voto de las últimas 1 h 30, por nombre de usuario (introducido en la página de votación) o por dirección 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"}

Posición en la categoría y votos

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}

Enviar las puntuaciones de los jugadores

Solo se guarda la mejor puntuación de cada jugador. Las puntuaciones aparecen en tu ficha y en las clasificaciones.

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 votos

Con cada voto, se envía una petición POST a la dirección configurada en el espacio del creador (5 s de espera como máximo, sin reintentos):

POST https://mon-jeu.fr/api/vote
Content-Type: application/json
X-JeuxInde-Signature: sha256=<HMAC-SHA256 del cuerpo con tu secreto, en hexadecimal>

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

Comprueba siempre la firma antes de dar una recompensa. Ejemplo 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));

Banner

Imagen SVG actualizada cada 10 minutos, con tu posición en tu categoría y tus votos del mes. El código HTML listo para pegar está en el espacio del creador.

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

Códigos de error

  • 401 : clave ausente o no válida.
  • 400 : falta un parámetro (el mensaje indica cuál).
  • 503 : servicio no disponible temporalmente.