# AlloyMC developers

> The AlloyMC API (https://api.alloymc.dev/v1) serves public Minecraft player profiles, follows, linked Minecraft accounts (with head and body renders) and Alloy launcher releases as JSON. Public reads need no key; CORS is open. Writes need a bearer token, which only the Alloy launcher can obtain today.

## Docs

- [AlloyMC developer docs](https://api.alloymc.dev/docs.md): What the AlloyMC API offers, how it's organised, and where to start.
- [Quickstart](https://api.alloymc.dev/docs/quickstart.md): Make your first AlloyMC API request with curl, JavaScript or Python, and show someone's avatar.
- [Authentication](https://api.alloymc.dev/docs/authentication.md): Public reads, bearer tokens, and exactly how Alloy signs people in with a one-time code and PKCE.
- [Conventions](https://api.alloymc.dev/docs/conventions.md): The rules every AlloyMC endpoint follows: JSON, errors, rate limits, pages of results, caching, handles and versions.
- [Profiles and follows](https://api.alloymc.dev/docs/profiles.md): The user object field by field, follower lists, and changing a profile or following someone with a token.
- [Minecraft accounts](https://api.alloymc.dev/docs/minecraft.md): Find the AlloyMC profile behind a Minecraft player, render heads and bodies, and how linking proves someone owns an account.
- [Images](https://api.alloymc.dev/docs/images.md): Avatars, sigils and skin renders as PNG links: sizes, caching and keeping pixel art crisp.
- [Recipes](https://api.alloymc.dev/docs/recipes.md): Copyable examples: a profile card on your website, a Discord bot command, and AlloyMC profiles for players on your Minecraft server.
- [API reference](https://api.alloymc.dev/docs/reference.md): Every AlloyMC API endpoint with its parameters and an example response, generated from the OpenAPI spec.
- [API changelog](https://api.alloymc.dev/docs/changelog.md): Every change to the AlloyMC API, newest first.
- [Developer roadmap](https://api.alloymc.dev/docs/roadmap.md): What's planned for developers on AlloyMC: apps with scopes, extensions for Alloy, a plugin platform and APIs for posts and packs.

## Machine-readable

- [OpenAPI 3.1 spec](https://api.alloymc.dev/v1/openapi.json)
- [Everything in one file](https://api.alloymc.dev/llms-full.txt)

## Related

- [AlloyMC](https://alloymc.dev/llms.txt)
- [Alloy launcher](https://launcher.alloymc.dev/llms.txt)
- [Terms of use](https://legal.alloymc.dev/terms.md)