Actions6
Overview
This node interacts with a URL shortening service API, specifically providing the ability to update an existing shortened URL's details. It is useful in scenarios where you need to modify properties of a previously created short URL without generating a new one. For example, you might want to change the destination long URL, update meta information for SEO or social sharing, add password protection, or set expiration dates.
Practical examples include:
- Updating the target URL if the original destination changes.
- Adding or changing a custom alias for branding purposes.
- Setting up geo-targeting or device-targeting rules to customize user experience.
- Protecting sensitive URLs with passwords.
- Managing campaign tracking pixels or deep linking configurations.
Properties
| Name | Meaning |
|---|---|
| ID Da URL | The unique identifier of the URL to be updated. |
| URL Longa | The new long URL that the shortened URL should redirect to. |
| Alias Personalizado | A custom alias for the shortened URL (optional). |
| Tipo De Redirecionamento | The type of redirection: "Direto" (direct), "Frame", or "Splash". |
| Senha | Password to protect the shortened URL (optional). |
| Domínio Personalizado | Custom domain for the shortened URL. Options include various predefined domains like demanda.sistema.chat, documento.sistema.chat, etc. |
| Data De Expiração | Expiration date/time for the shortened URL (format example: "2021-09-28 23:11:16"). |
| Título Meta | Meta title for the shortened URL (used for SEO or social sharing). |
| Descrição Meta | Meta description for the shortened URL. |
| Imagem Meta | Link to a JPG or PNG image used as meta image. |
| Geo Targeting | Geo-targeting data to control URL behavior based on user location. |
| Device Targeting | Device-targeting data to control URL behavior based on user device. |
| Language Targeting | Language-targeting data to control URL behavior based on user language. |
| Pixels | Array of pixel IDs for tracking purposes. |
| Channel ID | Channel identifier associated with the URL. |
| Deep Link | JSON object containing app store links for deep linking configuration. |
Output
The node outputs JSON data representing the result of the URL update operation. This typically includes confirmation of the updated URL details such as the new long URL, alias, redirection type, and any other metadata or targeting settings applied.
If the API supports it, the output may also contain status messages or error information related to the update process.
No binary data output is indicated by the source code.
Dependencies
- Requires connection to the URL shortening service API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- No additional external dependencies are indicated.
Troubleshooting
Common issues:
- Invalid or missing URL ID will cause the update to fail.
- Providing an invalid date format for expiration may result in errors.
- Using a custom alias already taken by another URL could cause conflicts.
- Incorrect or missing API credentials will prevent successful communication with the service.
Error messages:
- Errors related to authorization usually indicate missing or incorrect API keys.
- Validation errors from the API may specify which input property is invalid or missing.
- Network or connectivity errors suggest checking internet access or API endpoint availability.
To resolve these, verify all required fields are correctly filled, ensure API credentials are valid, and confirm network connectivity.
Links and References
- Refer to the URL shortening service API documentation for detailed field descriptions and constraints.
- n8n documentation on how to configure API credentials and use custom nodes.