Short.io icon

Short.io

Short.io Node for shortening and managing links

Actions6

Overview

This node integrates with the Short.io API to manage and shorten URLs. It supports operations such as listing links, retrieving link information, creating new shortened links, updating existing links, and deleting links. This is useful for marketing teams, content creators, or developers who want to programmatically handle URL shortening and tracking within their workflows.

For example, you can use this node to:

  • Generate short links for long URLs to share on social media.
  • Retrieve analytics or metadata about existing short links.
  • Update link properties like expiration dates or cloaking settings.
  • Delete outdated or invalid short links.

The specific operation "Generate QR For Link" is mentioned but not yet implemented in the provided code.

Properties

Name Meaning
Sorry, we haven't built this part yet. Notice indicating that the "Generate QR For Link" operation is not implemented yet.
This node was funded by a company only for specific functionality. We added all of the functions to show what is possible with the API. If you want extra functionality, feel free to reach out to us or submit a PR on the GitHub repo. Informational notice about the node's funding and invitation to contribute additional features.
liam@mcgarrigle.co Contact email presumably for support or inquiries related to the node or its development.

Note: The above are notices shown specifically when the "generateQrForLink" operation is selected. No actual input parameters for this operation are defined yet.

Output

The node outputs JSON data under the field json.shortIoResponse. Depending on the operation, this contains:

  • For listing links: an object with arrays of links, count, and pagination tokens.
  • For getting link info: detailed metadata about a specific short link.
  • For creating or updating links: the response from the API confirming the created or updated link details.
  • For deleting links: the API response confirming deletion.

No binary data output is indicated in the code.

Dependencies

  • Requires an API key credential for Short.io (referred generically as "an API key credential").
  • Uses the Short.io REST API at base URL https://api.short.io/api.
  • Relies on helper functions to get domain IDs and link info internally.
  • Requires network access to Short.io endpoints.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication failures.
    • Providing incorrect link IDs or paths may result in errors when fetching or updating links.
    • Pagination limits must be respected; requesting too many results at once triggers multiple paged requests internally.
  • Error messages:
    • Errors thrown by the API are wrapped and surfaced as node operation errors with item index context.
    • If "continue on fail" is enabled, errors for individual items are returned alongside the error details instead of stopping execution.
  • Resolution tips:
    • Verify API key validity and permissions.
    • Ensure link identifiers are correct and exist.
    • Use appropriate limits for list retrieval to avoid timeouts or rate limiting.

Links and References

Discussion