Developers
AlloyMC developers
Build on AlloyMC
Profiles, follows, linked Minecraft accounts and Alloy releases, over a JSON API. Public data needs no key, every origin may call it from a browser, and /v1 only ever grows.
Base URLhttps://api.alloymc.dev/v1
$ curl https://api.alloymc.dev/v1/status
{
"launcher": "0.2.1",
"ok": true,
"version": "0.1.21"
}Read the docs
- Start
Quickstart
Make your first AlloyMC API request with curl, JavaScript or Python, and show someone's avatar.
- Start
Authentication
Public reads, bearer tokens, and exactly how Alloy signs people in with a one-time code and PKCE.
- Use the API
Conventions
The rules every AlloyMC endpoint follows: JSON, errors, rate limits, pages of results, caching, handles and versions.
- Use the API
Profiles and follows
The user object field by field, follower lists, and changing a profile or following someone with a token.
- Use the API
Minecraft accounts
Find the AlloyMC profile behind a Minecraft player, render heads and bodies, and how linking proves someone owns an account.
- Use the API
Images
Avatars, sigils and skin renders as PNG links: sizes, caching and keeping pixel art crisp.
- Use the API
Recipes
Copyable examples: a profile card on your website, a Discord bot command, and AlloyMC profiles for players on your Minecraft server.
- Reference
API reference
Every AlloyMC API endpoint with its parameters and an example response, generated from the OpenAPI spec.
- Reference
API changelog
Every change to the AlloyMC API, newest first.
- Plans
Developer roadmap
What's planned for developers on AlloyMC: apps with scopes, extensions for Alloy, a plugin platform and APIs for posts and packs.
What people build with it
Each of these is a few lines, with code you can copy in Recipes.
A profile card on your site
Avatar, name and follower count from
GET /v1/users/{handle}.A Discord command
/alloy handle:kestrelanswers with an embed of the profile.Profiles for your server's players
Look up who a player is on AlloyMC by their Minecraft UUID.
Update checks
The newest Alloy version and its signed files from one endpoint.
Coming next
Apps, extensions, plugins
Your own apps acting for people with scopes they agree to, then extensions inside Alloy, then a plugin platform. The developer roadmap has the details; tell us what you need on GitHub.