Panorama de l'API Modrinth — Comment les outils interrogent Modrinth

À quoi sert l'API

Modrinth expose une API REST publique sur api.modrinth.com/v2 qui permet aux outils tiers (dont ce convertisseur) de rechercher des projets, lister des versions et récupérer des URL de téléchargement sans extraire les données du site.

Points d'accès utiles pour les outils de modpack

GET /project/{id|slug}

Renvoie les métadonnées du projet : titre, description, type (mod, modpack, pack de ressources), membres de l'équipe, licence.

GET /project/{id}/version

Liste toutes les versions publiées d'un projet, de la plus récente à la plus ancienne. Chaque entrée contient l'URL de téléchargement du fichier principal et une empreinte SHA-512.

GET /version_file/{hash}?algorithm=sha512

Recherche inversée : à partir d'une empreinte, retrouve la version correspondante. Pratique pour vérifier les ZIP convertis.

Limites de débit

Modrinth applique des limites généreuses pour un usage anonyme (300 requêtes par minute). Le convertisseur regroupe ses requêtes quand c'est possible et respecte les en-têtes Retry-After .

Authentification

La plupart des points d'accès en lecture fonctionnent sans authentification. Les requêtes authentifiées (publication, modification) exigent un jeton de compte Modrinth, que le convertisseur ne demande jamais puisqu'il ne modifie aucun contenu Modrinth.