# Versions et règles d’utilisation

https://gorally.games/developpeurs/versions

Ce que tu peux attendre de `/v1` dans le temps, les limites de ta clé et les règles à respecter.

## Versions

`/v1` n’évolue que par ajouts : nouvelle opération, nouveau champ de réponse, nouvelle valeur possible. Rien n’est retiré ni renommé.

Ton code doit donc ignorer les champs qu’il ne connaît pas. Un champ ajouté ne doit jamais le faire échouer.

## Rupture et préavis

Un changement qui casserait ton code passe par un `/v2`. `/v1` continue de répondre pendant le préavis.

Le préavis est de 6 mois. Tu le lis de trois façons :

- l’en-tête `Deprecation` sur chaque réponse de la version concernée ;
- l’en-tête `Sunset`, qui donne la date où elle cessera de répondre ;
- une entrée au journal des changements de l’API.

## Limites par clé

Chaque clé peut envoyer 120 requêtes par minute et 3 000 par heure. Au-delà, l’API répond 429 : attends avant de réessayer.

Ces limites peuvent changer. Tout changement est annoncé au journal des changements, avec préavis.

## Règles d’utilisation

En utilisant l’API, tu t’engages à respecter ces règles.

- Respecte les limites de ta clé.
- Ne revends pas les données de l’API.
- Rally peut révoquer une clé à tout moment, par exemple si ces règles ne sont pas respectées.
- Les données des personnes (joueurs, bénévoles) relèvent de la Loi 25 : traite-les comme telles.

## Pas de bac à sable

Il n’existe pas encore d’environnement d’essai. Une clé `rk_live_` agit sur les données réelles. Commence par une clé `read`, qui ne peut rien modifier.