Clash of Clans

Overview

This node integrates with the Clash of Clans API to retrieve detailed player achievement progress data. Specifically, the "Get Player Achievement Progress" operation fetches the current status of all achievements for a specified player by their unique player tag.

This node is beneficial in scenarios where you want to monitor or analyze a player's progress in Clash of Clans achievements programmatically. For example, game analysts, clan leaders, or community managers can use this node to track player milestones, reward eligibility, or to display achievement progress on external dashboards.

Practical examples:

• Automatically fetching and displaying a player's achievement progress on a website or app.
• Triggering notifications when a player completes certain achievements.
• Aggregating achievement data across multiple players for clan performance analysis.

Properties

Output

The output JSON contains an object with the following structure:

• operation: The name of the executed operation (getPlayerAchievements).
• url: The full URL used to query the Clash of Clans API for the player's achievements.
• data: The raw response from the Clash of Clans API containing the player's achievement progress details. This typically includes a list of achievements with their current levels, completion status, and related metadata.
• timestamp: The ISO timestamp when the request was made.
• metadata: Additional metadata including:
  • operationType: Categorizes the operation type (here it will be "player").
  • apiVersion: The version of the Clash of Clans API used ("v1").
  • processedAt: Timestamp indicating when the data was processed.

No binary data is output by this node.

Dependencies

• Requires an active Clash of Clans API key credential configured in n8n to authorize requests.
• Internet access to reach the official Clash of Clans API endpoint at https://api.clashofclans.com/v1.
• Proper configuration of the node's input property "Player Tag" with a valid player tag starting with #.

Troubleshooting

• Invalid Player Tag: If the player tag does not start with # or is malformed, the API may return an error. Ensure the player tag is correctly formatted.
• Authentication Errors: Missing or invalid API token will cause authorization failures. Verify that the API key credential is correctly set up and has necessary permissions.
• API Rate Limits: Frequent requests might hit rate limits imposed by the Clash of Clans API. Consider adding delays or handling rate limit errors gracefully.
• Network Issues: Connectivity problems can cause request failures. Check network access and proxy settings if applicable.
• Operation Not Supported: If an unsupported operation is selected, the node throws an error indicating the operation is not supported.

Links and References

• Clash of Clans Official API Documentation
• Clash of Clans Achievements Endpoint (refer to the Players section)
• n8n HTTP Request Helper Documentation