Liens réduits
Toutes les routes des liens réduits, avec pour chacune un exemple de requête et la réponse rendue. Un lien se désigne par son identifiant ou par son adresse personnalisée (slug).
- GET
/v1/linksLister les liens réduits - POST
/v1/linksRéduire une adresse - GET
/v1/links/{id}Lire un lien réduit - PATCH
/v1/links/{id}Modifier un lien réduit - DELETE
/v1/links/{id}Supprimer un lien réduit
Lister les liens réduits
GET/v1/links
Les liens réduits de l'environnement, du plus récent au plus ancien. Portée Lecture.
?search=— cherche dans la destination, l'adresse personnalisée et l'identifiant?tag=— identifiant d'un tag : seuls les liens qui le portent?page=et?per_page=— pagination, 50 par page par défaut, 100 au plus
curl "https://api.tinylink.fr/v1/links?search=promo" \
-H "Authorization: Bearer tl_votre_jeton"const response = await fetch('https://api.tinylink.fr/v1/links?search=promo', {
headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();$ch = curl_init('https://api.tinylink.fr/v1/links?search=promo');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer tl_votre_jeton'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
response = requests.get(
'https://api.tinylink.fr/v1/links?search=promo',
headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()Réponses possibles
{
"data": [
{
"id": "6ac401093831b",
"type": "link",
"target_url": "https://exemple.fr/promo",
"slug": "promo",
"url": "https://tnlnk.fr/promo",
"status": "active",
"password_protected": false,
"restricted": false,
"tags": [],
"qr_code": null,
"created_at": "2026-10-05T21:56:57+02:00",
"edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"total": 1,
"total_pages": 1
}
}Jeton absent de la requête
{
"error": {
"code": "missing_token",
"message": "Send your token in the header: Authorization: Bearer tl_…"
}
}Jeton inconnu ou révoqué
{
"error": {
"code": "invalid_token",
"message": "This token does not exist or has been revoked."
}
}L'offre du propriétaire n'inclut pas l'API
{
"error": {
"code": "plan_required",
"message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
}
}Le jeton ne porte pas la portée Lecture
{
"error": {
"code": "insufficient_scope",
"message": "This token does not have the \"read\" scope.",
"details": {
"required_scope": "read"
}
}
}Plus de 120 requêtes dans la minute
{
"error": {
"code": "rate_limited",
"message": "Too many requests: 120 per minute per token."
}
}Réduire une adresse
POST/v1/links
url est obligatoire : une adresse web, un e-mail ou un téléphone. La réponse est le lien créé ; url y est l'adresse courte, target_url la destination. Portée Écriture.
url— la destination, 500 caractères au plusslug— l'adresse personnalisée : lettres, chiffres,-,_et., 40 caractères au pluspassword— protège le lien par un mot de passetags— liste d'identifiants de tags de l'environnementqr_code—truepour le QR code classique,"none"sans logo, ou l'identifiant d'un modèle
curl -X POST https://api.tinylink.fr/v1/links \
-H "Authorization: Bearer tl_votre_jeton" \
-H "Content-Type: application/json" \
-d '{
"url": "https://exemple.fr/promo",
"slug": "promo",
"qr_code": "none"
}'const response = await fetch('https://api.tinylink.fr/v1/links', {
method: 'POST',
headers: {
Authorization: 'Bearer tl_votre_jeton',
'Content-Type': 'application/json',
},
body: JSON.stringify({
url: 'https://exemple.fr/promo',
slug: 'promo',
qr_code: 'none',
}),
});
const data = await response.json();$ch = curl_init('https://api.tinylink.fr/v1/links');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer tl_votre_jeton', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'url' => 'https://exemple.fr/promo',
'slug' => 'promo',
'qr_code' => 'none',
]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
response = requests.post(
'https://api.tinylink.fr/v1/links',
headers={'Authorization': 'Bearer tl_votre_jeton'},
json={
'url': 'https://exemple.fr/promo',
'slug': 'promo',
'qr_code': 'none',
},
)
data = response.json()Réponses possibles
{
"id": "6ac401093831b",
"type": "link",
"target_url": "https://exemple.fr/promo",
"slug": "promo",
"url": "https://tnlnk.fr/promo",
"status": "active",
"password_protected": false,
"restricted": false,
"tags": [],
"qr_code": {
"png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
"svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
"template": "none",
"shape": "square",
"encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
},
"created_at": "2026-10-05T21:56:57+02:00",
"edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}Le corps n'est pas un objet JSON
{
"error": {
"code": "invalid_json",
"message": "The request body must be a JSON object."
}
}Jeton absent de la requête
{
"error": {
"code": "missing_token",
"message": "Send your token in the header: Authorization: Bearer tl_…"
}
}Jeton inconnu ou révoqué
{
"error": {
"code": "invalid_token",
"message": "This token does not exist or has been revoked."
}
}Nombre de liens réduits de l'offre atteint
{
"error": {
"code": "plan_limit_reached",
"message": "The link limit of the plan has been reached."
}
}L'offre du propriétaire n'inclut pas l'API
{
"error": {
"code": "plan_required",
"message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
}
}Le jeton ne porte pas la portée Écriture
{
"error": {
"code": "insufficient_scope",
"message": "This token does not have the \"write\" scope.",
"details": {
"required_scope": "write"
}
}
}Adresse personnalisée déjà utilisée par une page ou un lien
{
"error": {
"code": "slug_taken",
"message": "This slug is already taken.",
"details": {
"field": "slug"
}
}
}Champ obligatoire absent ou vide
{
"error": {
"code": "validation_failed",
"message": "The \"url\" field is required (a string).",
"details": {
"field": "url"
}
}
}Ni adresse web, ni e-mail, ni téléphone
{
"error": {
"code": "invalid_url",
"message": "This is not a valid web address, e-mail address or phone number.",
"details": {
"field": "url"
}
}
}Domaine signalé comme suspect
{
"error": {
"code": "suspicious_url",
"message": "This address is on our list of suspicious domains and cannot be used.",
"details": {
"field": "url"
}
}
}Plus de 120 requêtes dans la minute
{
"error": {
"code": "rate_limited",
"message": "Too many requests: 120 per minute per token."
}
}Lire un lien réduit
GET/v1/links/{id}
status vaut active, pending_review (en cours de vérification, le lien ne redirige pas encore) ou blocked. Portée Lecture.
curl https://api.tinylink.fr/v1/links/promo \
-H "Authorization: Bearer tl_votre_jeton"const response = await fetch('https://api.tinylink.fr/v1/links/promo', {
headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();$ch = curl_init('https://api.tinylink.fr/v1/links/promo');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer tl_votre_jeton'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
response = requests.get(
'https://api.tinylink.fr/v1/links/promo',
headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()Réponses possibles
{
"id": "6ac401093831b",
"type": "link",
"target_url": "https://exemple.fr/promo",
"slug": "promo",
"url": "https://tnlnk.fr/promo",
"status": "active",
"password_protected": false,
"restricted": false,
"tags": [],
"qr_code": {
"png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
"svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
"template": "none",
"shape": "square",
"encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
},
"created_at": "2026-10-05T21:56:57+02:00",
"edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}Jeton absent de la requête
{
"error": {
"code": "missing_token",
"message": "Send your token in the header: Authorization: Bearer tl_…"
}
}Jeton inconnu ou révoqué
{
"error": {
"code": "invalid_token",
"message": "This token does not exist or has been revoked."
}
}L'offre du propriétaire n'inclut pas l'API
{
"error": {
"code": "plan_required",
"message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
}
}Le jeton ne porte pas la portée Lecture
{
"error": {
"code": "insufficient_scope",
"message": "This token does not have the \"read\" scope.",
"details": {
"required_scope": "read"
}
}
}Aucun lien réduit avec cet identifiant ou ce slug dans l'environnement
{
"error": {
"code": "not_found",
"message": "Link not found in this environment."
}
}Plus de 120 requêtes dans la minute
{
"error": {
"code": "rate_limited",
"message": "Too many requests: 120 per minute per token."
}
}Modifier un lien réduit
PATCH/v1/links/{id}
N'envoyez que les champs à changer : url (la destination), slug, password. null retire l'adresse personnalisée ou le mot de passe. Changer la destination ne change pas l'adresse courte. Portée Écriture.
curl -X PATCH https://api.tinylink.fr/v1/links/6ac401093831b \
-H "Authorization: Bearer tl_votre_jeton" \
-H "Content-Type: application/json" \
-d '{"url":"https://exemple.fr/soldes"}'const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b', {
method: 'PATCH',
headers: {
Authorization: 'Bearer tl_votre_jeton',
'Content-Type': 'application/json',
},
body: JSON.stringify({ url: 'https://exemple.fr/soldes' }),
});
const data = await response.json();$ch = curl_init('https://api.tinylink.fr/v1/links/6ac401093831b');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer tl_votre_jeton', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode(['url' => 'https://exemple.fr/soldes']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
response = requests.patch(
'https://api.tinylink.fr/v1/links/6ac401093831b',
headers={'Authorization': 'Bearer tl_votre_jeton'},
json={'url': 'https://exemple.fr/soldes'},
)
data = response.json()Réponses possibles
{
"id": "6ac401093831b",
"type": "link",
"target_url": "https://exemple.fr/soldes",
"slug": "promo",
"url": "https://tnlnk.fr/promo",
"status": "active",
"password_protected": false,
"restricted": false,
"tags": [],
"qr_code": {
"png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
"svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
"template": "none",
"shape": "square",
"encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
},
"created_at": "2026-10-05T21:56:57+02:00",
"edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}Le corps n'est pas un objet JSON
{
"error": {
"code": "invalid_json",
"message": "The request body must be a JSON object."
}
}Jeton absent de la requête
{
"error": {
"code": "missing_token",
"message": "Send your token in the header: Authorization: Bearer tl_…"
}
}Jeton inconnu ou révoqué
{
"error": {
"code": "invalid_token",
"message": "This token does not exist or has been revoked."
}
}L'offre du propriétaire n'inclut pas l'API
{
"error": {
"code": "plan_required",
"message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
}
}Le jeton ne porte pas la portée Écriture
{
"error": {
"code": "insufficient_scope",
"message": "This token does not have the \"write\" scope.",
"details": {
"required_scope": "write"
}
}
}Aucun lien réduit avec cet identifiant ou ce slug dans l'environnement
{
"error": {
"code": "not_found",
"message": "Link not found in this environment."
}
}Adresse personnalisée déjà utilisée par une page ou un lien
{
"error": {
"code": "slug_taken",
"message": "This slug is already taken.",
"details": {
"field": "slug"
}
}
}Aucun champ modifiable dans le corps
{
"error": {
"code": "validation_failed",
"message": "Nothing to update. Accepted fields: url, slug, password."
}
}Ni adresse web, ni e-mail, ni téléphone
{
"error": {
"code": "invalid_url",
"message": "This is not a valid web address, e-mail address or phone number.",
"details": {
"field": "url"
}
}
}Élément bloqué par la modération
{
"error": {
"code": "element_blocked",
"message": "This element is blocked by moderation and can no longer be modified."
}
}Plus de 120 requêtes dans la minute
{
"error": {
"code": "rate_limited",
"message": "Too many requests: 120 per minute per token."
}
}Supprimer un lien réduit
DELETE/v1/links/{id}
Supprime le lien, son QR code et ses statistiques : l'adresse courte cesse de rediriger. Irréversible. Portée Suppression.
curl -X DELETE https://api.tinylink.fr/v1/links/6ac401093831b \
-H "Authorization: Bearer tl_votre_jeton"const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b', {
method: 'DELETE',
headers: { Authorization: 'Bearer tl_votre_jeton' },
});
console.log(response.status); // 204$ch = curl_init('https://api.tinylink.fr/v1/links/6ac401093831b');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer tl_votre_jeton'],
]);
curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); // 204
curl_close($ch);import requests
response = requests.delete(
'https://api.tinylink.fr/v1/links/6ac401093831b',
headers={'Authorization': 'Bearer tl_votre_jeton'},
)
print(response.status_code) # 204Réponses possibles
Sans contenu
Jeton absent de la requête
{
"error": {
"code": "missing_token",
"message": "Send your token in the header: Authorization: Bearer tl_…"
}
}Jeton inconnu ou révoqué
{
"error": {
"code": "invalid_token",
"message": "This token does not exist or has been revoked."
}
}L'offre du propriétaire n'inclut pas l'API
{
"error": {
"code": "plan_required",
"message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
}
}Le jeton ne porte pas la portée Suppression
{
"error": {
"code": "insufficient_scope",
"message": "This token does not have the \"delete\" scope.",
"details": {
"required_scope": "delete"
}
}
}Aucun lien réduit avec cet identifiant ou ce slug dans l'environnement
{
"error": {
"code": "not_found",
"message": "Link not found in this environment."
}
}Plus de 120 requêtes dans la minute
{
"error": {
"code": "rate_limited",
"message": "Too many requests: 120 per minute per token."
}
}