Overzicht van de Modrinth-API — Hoe tools Modrinth bevragen

Waar de API voor dient

Modrinth biedt een openbare REST-API op api.modrinth.com/v2 waarmee tools van derden (waaronder deze converter) projecten kunnen opzoeken, versies kunnen opsommen en download-URL's kunnen ophalen zonder de website te scrapen.

Nuttige endpoints voor modpacktools

GET /project/{id|slug}

Geeft de metadata van het project terug: titel, omschrijving, projecttype (mod, modpack, resourcepack), teamleden en licentie.

GET /project/{id}/version

Somt alle gepubliceerde versies van een project op, nieuwste eerst. Elke vermelding bevat de download-URL van het hoofdbestand en een SHA-512-hash.

GET /version_file/{hash}?algorithm=sha512

Omgekeerd opzoeken: gegeven een hash, vind de versie die hem opleverde. Handig om geconverteerde ZIP's te controleren.

Aanvraaglimieten

Modrinth hanteert ruime limieten voor anoniem gebruik (300 verzoeken per minuut). De converter bundelt verzoeken waar dat kan en respecteert Retry-After -headers.

Authenticatie

De meeste leesendpoints werken anoniem. Geverifieerde verzoeken (publiceren, bewerken) vereisen een Modrinth-accounttoken, en daar vraagt de converter nooit om, omdat hij geen Modrinth-inhoud aanpast.