Actions17
- Clans Actions
- Players Actions
- Tournaments Actions
- Locations Actions
- Leaderboards Actions
Overview
The "Get Tournament Rankings" operation in the Locations resource of this Clash Royale node fetches ranking data for a specified tournament. This allows users to retrieve leaderboard information about players or clans participating in a particular tournament identified by its tag.
Common scenarios where this node is beneficial include:
- Displaying tournament leaderboards on websites or apps.
- Analyzing player or clan performance in specific tournaments.
- Integrating tournament ranking data into dashboards or reports.
For example, a user can input a tournament tag (without the "#" symbol) to get the top-ranked players or clans in that tournament, optionally limiting the number of results or paginating through them.
Properties
| Name | Meaning |
|---|---|
| Tournament Tag | The unique identifier (tag) of the tournament without the "#" symbol. Required to specify which tournament's rankings to fetch. Example: "2ABC". |
| Additional Fields | Optional parameters to refine the query: |
| - Limit | Maximum number of ranking results to return. Default is 50. |
| - After | Pagination marker to return only items occurring after this marker. |
| - Before | Pagination marker to return only items occurring before this marker. |
Output
The output JSON contains the tournament rankings data retrieved from the Clash Royale API. This typically includes an array of ranking entries, each representing a player or clan with their rank, name, tag, and possibly other statistics related to their tournament performance.
If the API supports pagination, the output may also include markers or cursors to fetch additional pages of results using the "after" and "before" properties.
This node does not output binary data.
Dependencies
- Requires an active API key credential for the Clash Royale API.
- The base URL defaults to
https://api.clashroyale.com/v1but can be overridden via credentials. - Proper network access to the Clash Royale API endpoint is necessary.
Troubleshooting
- Invalid Tournament Tag: If the provided tournament tag is incorrect or does not exist, the API will likely return an error or empty results. Verify the tag format and existence.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key credential is correctly configured.
- Rate Limits: The Clash Royale API enforces rate limits; excessive requests may result in temporary blocking. Implement retries with backoff if needed.
- Pagination Issues: Using invalid "after" or "before" markers may lead to empty responses or errors. Use markers returned from previous calls.