Panoramica dell'API Modrinth — Come gli strumenti interrogano Modrinth

A cosa serve l'API

Modrinth espone un'API REST pubblica su api.modrinth.com/v2 che consente a strumenti di terze parti (compreso questo convertitore) di cercare progetti, elencare versioni e ottenere URL di download senza fare scraping del sito.

Endpoint utili per gli strumenti sui modpack

GET /project/{id|slug}

Restituisce i metadati del progetto: titolo, descrizione, tipo (mod, modpack, pacchetto risorse), membri del team, licenza.

GET /project/{id}/version

Elenca tutte le versioni pubblicate di un progetto, dalla più recente. Ogni voce include l'URL di download del file principale e un hash SHA-512.

GET /version_file/{hash}?algorithm=sha512

Ricerca inversa: dato un hash, trova la versione che lo ha generato. Utile per verificare gli ZIP convertiti.

Limiti di frequenza

Modrinth applica limiti generosi per l'uso anonimo (300 richieste al minuto). Il convertitore raggruppa le richieste quando può e rispetta gli header Retry-After .

Autenticazione

La maggior parte degli endpoint di lettura funziona in modo anonimo. Le richieste autenticate (pubblicazione, modifica) richiedono un token dell'account Modrinth, che il convertitore non chiede mai perché non modifica contenuti su Modrinth.