When the
"Use existing URL if found"
checkbox is checked, the server will return an existing short URL if it matches provided params.
These are the checks performed by Shlink in order to determine if an existing short URL should be returned:
-
When only the long URL is provided: The most recent match will be returned, or a new short URL will be created
if none is found
-
When long URL and custom slug are provided: Same as in previous case, but it will try to match the short URL
using both the long URL and the slug.
If the slug is being used by another long URL, an error will be returned.
-
When other params are provided: Same as in previous cases, but it will try to match existing short URLs with
all provided data. If any of them does not match, a new short URL will be created
Important: This feature will be ignored while using a Shlink version older than v1.16.0.