Actions7
Overview
This node interacts with the Roblox Cloud API to generate a thumbnail image for a specified Roblox user. It is useful when you want to retrieve a visual representation (avatar thumbnail) of a user by their Roblox user ID. Common scenarios include displaying user avatars in dashboards, reports, or any application that integrates Roblox user data visually.
For example, if you have a list of Roblox user IDs and want to show their profile pictures in your app, this node can fetch thumbnails in various sizes, formats, and shapes.
Properties
| Name | Meaning |
|---|---|
| User ID | The Roblox user ID for which to generate the thumbnail. This is a required string input. |
| Query Parameters | A collection of optional parameters to customize the thumbnail generation: |
| - Size | The size of the thumbnail image. Options: 48x48, 50x50, 60x60, 75x75, 100x100, 110x110, 150x150, 180x180, 352x352, 420x420, 720x720. Default is 420x420. |
| - Format | The image format of the thumbnail. Options: PNG, JPEG. Default is PNG. |
| - Shape | The shape of the thumbnail. Options: Round, Square. Default is Round. |
Output
The node outputs JSON data containing the generated thumbnail information for the specified user. Typically, this includes URLs or metadata about the thumbnail image in the requested size, format, and shape.
If the node supports binary data output (not explicitly shown in the provided code), it would represent the actual image file data of the thumbnail.
Dependencies
- Requires an API key credential for Roblox Cloud API access.
- The node makes HTTP requests to
https://apis.roblox.com. - Proper configuration of the API key credential in n8n is necessary for authentication.
Troubleshooting
- Invalid User ID: If the provided user ID does not exist or is invalid, the API may return an error or empty result. Verify the user ID before use.
- API Key Issues: Missing or incorrect API key will cause authentication failures. Ensure the API key credential is correctly set up.
- Unsupported Size/Format/Shape: Using unsupported values outside the provided options may cause errors or unexpected results.
- Network Errors: Connectivity issues to the Roblox API endpoint can cause request failures. Check network settings and API availability.
Links and References
- Roblox Developer Hub
- Roblox Cloud API Documentation (general reference; specific endpoints depend on API version)