Saltar al contenido

Para desarrolladores

API pública

API JSON en /api/v1 para consultar mods, mapas y skins y descargar archivos. Solo lectura.

URL base

https://dromorcraft.com/api/v1

Projects

get /projects

Search published projects, or get several by id

get /search

Alias of GET /projects

get /projects/{idOrSlug}

Get a project

get /projects/{idOrSlug}/dependencies

Public projects and versions the published versions depend on (required, optional, embedded)

Versions

get /projects/{idOrSlug}/versions

List published versions (newest first)

get /projects/{idOrSlug}/versions/{version}

Get one version of a project

get /versions

Get several versions by id (max 100, in the order asked)

get /versions/{id}

Get a version by id

Files

get /projects/{idOrSlug}/files

Files of the current version

get /version-files

Identify many installed files at once: hash → version that contains it

get /version-files/update

Check updates for many files: hash → newest compatible version of the same project

get /version-files/{hash}

Find the version that contains a file (identify installed files, check updates)

get /version-files/{hash}/update

Newest published version of the same project that matches the filters (the installed one when it is already the newest)

get /files/{id}/download

Download a published file (302 to the immutable object; counted once per visitor and day)

Users

get /users

Get several public profiles by id or username (max 50)

get /users/{username}

Public profile

get /users/{username}/projects

Public projects of a user

Reference

get /categories

Categories

get /types

Enabled content types and their file rules

get /minecraft/versions

Minecraft versions

get /statistics

Platform totals: published projects, versions, files, authors and downloads

get /openapi.json

This document

Ejemplos

Buscar mods para Fabric 1.21.4

curl "https://dromorcraft.com/api/v1/projects?type=mod&platform=fabric&gameVersion=1.21.4&sort=downloads&limit=10"

Un proyecto y sus versiones

curl "https://dromorcraft.com/api/v1/projects/<slug>"
curl "https://dromorcraft.com/api/v1/projects/<slug>/versions?channel=stable"

Identificar un archivo instalado por su hash (SHA-1 o SHA-256)

curl "https://dromorcraft.com/api/v1/version-files/<sha1>"
curl "https://dromorcraft.com/api/v1/version-files/<sha256>?algorithm=sha256"

Varios proyectos o archivos en una petición

curl "https://dromorcraft.com/api/v1/projects?ids=<id>,<slug>"
curl "https://dromorcraft.com/api/v1/version-files?hashes=<sha1>,<sha1>"

Buscar actualizaciones compatibles con Fabric 1.21.4

curl "https://dromorcraft.com/api/v1/version-files/update?hashes=<sha1>,<sha1>&platform=fabric&gameVersion=1.21.4"

Descargar un archivo (redirige al archivo)

curl -L -o mod.jar "https://dromorcraft.com/api/v1/files/<fileId>/download"