Magma Website API

This documentation covers the public API endpoints available on the Magma website. These endpoints can be used to access information about Magma versions and other data programmatically, making them useful for tools, launchers, or integrations.

Available Endpoints

• Versions List API - Get a list of available Magma versions
• Version Details API - Get detailed information about a specific version
• Download API - Direct download of a specific version
• Latest Version API - Get information about the latest version
• Latest Download API - Direct download of the latest version

Implementation Notes

The API works by fetching and parsing the Maven metadata from the official Magma repository and has the following features:

• Automatically detects the Minecraft version from the Magma version string
• Identifies stable vs beta/development versions
• Caches responses for 1 hour to reduce load on the Maven server
• Limits results by default to improve performance
• Falls back to alternative methods if the primary method fails
• Returns an empty array if no versions can be found (does not use fallback data)

Error Handling

The API returns appropriate HTTP status codes:

• 200 OK: Request successful, data returned
• 500 Internal Server Error: Server error occurred

When no versions are found but the API itself works properly, it will return a 200 status with an empty versions array:

{
  "total": 0,
  "limit": 10,
  "versions": []
}

Rate Limiting

Be considerate with your API usage. While there are currently no strict rate limits enforced, excessive requests may be throttled in the future.