To deliver images, videos, etc., Miwa.lol uses a Content Delivery Network (CDN). This ensures that content is delivered quickly and efficiently to users around the world. We use a specific URL format to keep files organized and easy to access.
In most cases, you won't need to construct these URLs manually, as they are provided by our API when you request user data or other resources. In some cases, though, the API returns only a resource ID, so you'll need to build the URL yourself using the format below.
URL Structure
The general format for accessing files via our CDN is as follows:
https://cdn.miwa.lol/{type}/{filename}.{extension}
Parameters
{type}: Indicates the type of asset you are accessing. See below for more details.{filename}: Unique identifier for the file, typically a UUID.{extension}: Indicates the file format.
Assets type
| Type | Details |
|---|---|
avatars | User avatar images |
backgrounds | User background images |
cursors | Custom cursor images |
audios | Audio files. The extension is always mp3.In the API, the URL is not directly provided; instead, you get the audio ID, which you can use to construct the URL. |
audios-covers | Audio cover images |
fonts | Custom font files. Feature only available for Premium users. |
Example: building an audio URL
The Get User endpoint returns audio entries with only an ID — for example:
{
"audios": [
{ "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab" }
]
}To play it, build the URL by plugging the ID into the CDN format with the mp3 extension:
https://cdn.miwa.lol/audios/a1b2c3d4-5678-90ab-cdef-1234567890ab.mp3