Shlink icon

Shlink

Interact with Shlink URL Shortener API

Actions12

Overview

This node integrates with the Shlink URL Shortener API to manage domains associated with shortened URLs. Specifically, the Domain - Get Many operation retrieves a list of domains configured in the Shlink instance.

Common scenarios for this node include:

  • Fetching all available domains to display or use in subsequent workflow steps.
  • Retrieving a limited number of domains when only a subset is needed.
  • Automating domain management tasks by integrating domain data into other systems.

For example, you might use this node to get all domains and then loop through them to generate reports on URL usage per domain or to synchronize domain lists with another service.

Properties

Name Meaning
Return All Whether to return all domains available or only up to a specified limit.
Limit The maximum number of domain results to return (ignored if "Return All" is true).

Output

The output is a JSON array where each item represents a domain object as returned by the Shlink API. Each domain object typically contains details such as the domain name and any associated metadata managed by Shlink.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "domain": "example.com",
    "isDefault": true,
    "redirectStatusCode": 301
  },
  {
    "domain": "short.example.org",
    "isDefault": false,
    "redirectStatusCode": 302
  }
]

Dependencies

  • Requires an API key credential for authenticating with the Shlink API.
  • The base URL of the Shlink instance must be configured in the credentials.
  • The node makes HTTP requests to the Shlink REST API endpoints.

Troubleshooting

  • Invalid Base URL: If the base URL does not start with http:// or https://, the node automatically prepends https://. Ensure your base URL is correct to avoid connection issues.
  • Authentication Errors: Make sure the API key credential is valid and has sufficient permissions.
  • API Rate Limits or Network Issues: Requests may fail due to rate limiting or connectivity problems; check network access and API limits.
  • Empty Results: If no domains are returned, verify that domains exist in your Shlink instance and that filters (if any) are correctly set.

Links and References

Discussion