Blocklet Server icon

Blocklet Server

Consume Blocklet Server API
Join our community

Actions10

Overview

This node interacts with the Blocklet Server API to manage tags associated with a Blocklet app (team). Specifically, the "Get Tags" operation retrieves a list of tags for a given app identified by its DID (Decentralized Identifier). This is useful in scenarios where you want to fetch and display tags related to your app's content or users, enabling categorization, filtering, or metadata management.

Practical examples include:

  • Fetching all tags to show in a user interface for selection or filtering.
  • Synchronizing tag data from the Blocklet Server into another system.
  • Automating workflows based on tag information retrieved from the server.

Properties

Name Meaning
App DID The DID (Decentralized Identifier) of the blocklet app (team) whose tags are to be fetched.
Paging Options to control pagination of the results:
- Page The page number to fetch (default is 1).
- Page Size The number of items per page (default is 50).

Output

The output is a JSON array where each item represents a tag object retrieved from the Blocklet Server. Each tag typically includes properties such as its ID, title, description, color, and any other metadata defined by the Blocklet Server API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the Blocklet Server API.
  • The node depends on the blockletServerApiRequest function internally to make HTTP requests to the Blocklet Server.
  • No additional external services beyond the Blocklet Server API are required.

Troubleshooting

  • Common issues:

    • Invalid or missing App DID: Ensure the DID provided is correct and corresponds to an existing Blocklet app.
    • Pagination parameters out of range: Verify that the page number and page size are positive integers.
    • Authentication errors: Confirm that the API key credential is correctly set up and has sufficient permissions.

  • Error messages:

    • "Not implemented tag action: getTags": Indicates a mismatch between the selected operation and the implemented code; should not occur if using the node as intended.
    • Network or API errors will return messages from the Blocklet Server API; check connectivity and credentials.

Links and References

Discussion