CDN-Routes

CDN Service

The CDN service is responsible for serving user-facing media assets efficiently and managing cache invalidation when assets change. It acts as a lightweight file delivery layer, ensuring profile images are cached and served with minimal latency while remaining up to date when users update or remove their avatars.

Profile image routes within this service handle both cache invalidation and image delivery at different resolutions.

POST /user/avatar/change/:id

Invalidates cached profile image entries for a specific user. This endpoint is typically called by internal services after a user updates or deletes their profile image.

This endpoint is intended for internal service use and does not require user authentication.

{
    "data": "Success",
    "code": 200
}

{
    "data": "Required parameters missing",
    "code": 400
}

GET /user/avatar/:id/:res

Returns a user’s profile image at the requested resolution. If no custom profile image exists, a default image is returned.

If no resolution is provided, scaled is used by default.

{
    "data": "Required parameters missing",
    "code": 400
}

{
    "data": "User not found",
    "code": 404
}

• Profile images are cached by user ID and resolution
• Cache entries are automatically invalidated via the change endpoint
• Default images are returned for users without a custom profile image
• This endpoint serves files directly from disk for maximum performance