Pages et liens d'une page

Toutes les routes des pages et de leurs liens, avec pour chacune un exemple de requête et la réponse rendue. Une page se désigne par son identifiant ou par son adresse personnalisée (slug).

GET/v1/pagesLister les pages
POST/v1/pagesCréer une page
GET/v1/pages/{id}Lire une page
PATCH/v1/pages/{id}Modifier une page
DELETE/v1/pages/{id}Supprimer une page
GET/v1/pages/{id}/linksLister les liens d'une page
POST/v1/pages/{id}/linksAjouter un lien
GET/v1/pages/{id}/links/{lien}Lire un lien
PATCH/v1/pages/{id}/links/{lien}Modifier un lien
DELETE/v1/pages/{id}/links/{lien}Supprimer un lien

Lister les pages

GET/v1/pages

Les pages de l'environnement, de la plus récente à la plus ancienne. Portée Lecture.

?search= — cherche dans le nom, l'adresse personnalisée et l'identifiant
?tag= — identifiant d'un tag : seules les pages qui le portent
?page= et ?per_page= — pagination, 50 par page par défaut, 100 au plus

curl "https://api.tinylink.fr/v1/pages?per_page=2" \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages?per_page=2', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages?per_page=2');
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/pages?per_page=2',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()

Réponses possibles

{
  "data": [
    {
      "id": "P6ac40109381964",
      "type": "page",
      "name": "Ma page",
      "description": "Tous mes liens au même endroit.",
      "slug": "ma-page",
      "url": "https://tnylnk.fr/ma-page",
      "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/page-edit?id=P6ac40109381964"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 2,
    "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."
  }
}

Créer une page

POST/v1/pages

name est obligatoire. La réponse est la page créée, avec ses liens. Portée Écriture.

name — le nom de la page, 100 caractères au plus
description — 2 000 caractères au plus
slug — l'adresse personnalisée : lettres, chiffres, -, _ et ., 40 caractères au plus
password — protège la page par un mot de passe
tags — liste d'identifiants de tags de l'environnement
qr_code — true pour le QR code classique, ou l'identifiant d'un modèle
links — liens à ajouter d'un coup (100 au plus), décrits comme dans « Ajouter un lien »

curl -X POST https://api.tinylink.fr/v1/pages \
  -H "Authorization: Bearer tl_votre_jeton" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ma page",
    "slug": "ma-page",
    "links": [
      {
        "title": "Mon site",
        "url": "https://exemple.fr"
      },
      {
        "title": "Contact",
        "url": "bonjour@exemple.fr"
      }
    ]
  }'

const response = await fetch('https://api.tinylink.fr/v1/pages', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_votre_jeton',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Ma page',
    slug: 'ma-page',
    links: [
      { title: 'Mon site', url: 'https://exemple.fr' },
      { title: 'Contact', url: 'bonjour@exemple.fr' },
    ],
  }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages');
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([
        'name' => 'Ma page',
        'slug' => 'ma-page',
        'links' => [
            ['title' => 'Mon site', 'url' => 'https://exemple.fr'],
            ['title' => 'Contact', 'url' => 'bonjour@exemple.fr'],
        ],
    ]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/pages',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
    json={
        'name': 'Ma page',
        'slug': 'ma-page',
        'links': [
            {'title': 'Mon site', 'url': 'https://exemple.fr'},
            {'title': 'Contact', 'url': 'bonjour@exemple.fr'},
        ],
    },
)
data = response.json()

Réponses possibles

{
  "id": "P6ac40109381964",
  "type": "page",
  "name": "Ma page",
  "description": "",
  "slug": "ma-page",
  "url": "https://tnylnk.fr/ma-page",
  "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/page-edit?id=P6ac40109381964",
  "links": [
    {
      "id": "L6ac4011edb7c6",
      "title": "Mon site",
      "description": "",
      "url": "https://exemple.fr",
      "type": "url",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 1,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    },
    {
      "id": "L6ac4011ee9fab",
      "title": "Contact",
      "description": "",
      "url": "bonjour@exemple.fr",
      "type": "email",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 2,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    }
  ]
}

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 pages de l'offre atteint

{
  "error": {
    "code": "plan_limit_reached",
    "message": "The page 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 \"name\" field is required.",
    "details": {
      "field": "name"
    }
  }
}

Plus de 120 requêtes dans la minute

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Lire une page

GET/v1/pages/{id}

La page et ses liens, dans l'ordre d'affichage ; les liens archivés viennent en dernier. Portée Lecture.

curl https://api.tinylink.fr/v1/pages/ma-page \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages/ma-page', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/ma-page');
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/pages/ma-page',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()

Réponses possibles

{
  "id": "P6ac40109381964",
  "type": "page",
  "name": "Ma page",
  "description": "Tous mes liens au même endroit.",
  "slug": "ma-page",
  "url": "https://tnylnk.fr/ma-page",
  "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/page-edit?id=P6ac40109381964",
  "links": [
    {
      "id": "L6ac4011edb7c6",
      "title": "Mon site",
      "description": "",
      "url": "https://exemple.fr",
      "type": "url",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 1,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    },
    {
      "id": "L6ac4011ee9fab",
      "title": "Contact",
      "description": "",
      "url": "bonjour@exemple.fr",
      "type": "email",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 2,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    }
  ]
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page 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 une page

PATCH/v1/pages/{id}

N'envoyez que les champs à changer : name, description, slug, password. null retire l'adresse personnalisée ou le mot de passe. La réponse est la page à jour. Portée Écriture.

curl -X PATCH https://api.tinylink.fr/v1/pages/P6ac40109381964 \
  -H "Authorization: Bearer tl_votre_jeton" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Tous mes liens au même endroit.",
    "password": null
  }'

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer tl_votre_jeton',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    description: 'Tous mes liens au même endroit.',
    password: null,
  }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964');
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([
        'description' => 'Tous mes liens au même endroit.',
        'password' => null,
    ]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.patch(
    'https://api.tinylink.fr/v1/pages/P6ac40109381964',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
    json={
        'description': 'Tous mes liens au même endroit.',
        'password': None,
    },
)
data = response.json()

Réponses possibles

{
  "id": "P6ac40109381964",
  "type": "page",
  "name": "Ma page",
  "description": "Tous mes liens au même endroit.",
  "slug": "ma-page",
  "url": "https://tnylnk.fr/ma-page",
  "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/page-edit?id=P6ac40109381964",
  "links": [
    {
      "id": "L6ac4011edb7c6",
      "title": "Mon site",
      "description": "",
      "url": "https://exemple.fr",
      "type": "url",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 1,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    },
    {
      "id": "L6ac4011ee9fab",
      "title": "Contact",
      "description": "",
      "url": "bonjour@exemple.fr",
      "type": "email",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 2,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    }
  ]
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page 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: name, description, slug, password."
  }
}

É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 une page

DELETE/v1/pages/{id}

Supprime la page, ses liens et ses statistiques. Irréversible. Portée Suppression.

curl -X DELETE https://api.tinylink.fr/v1/pages/P6ac40109381964 \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
console.log(response.status); // 204

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964');
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/pages/P6ac40109381964',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
print(response.status_code)  # 204

Ré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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page 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."
  }
}

Lister les liens d'une page

GET/v1/pages/{id}/links

Les liens de la page, dans l'ordre d'affichage. type vaut url, email, tel ou title ; status vaut active, pending_review ou blocked. Portée Lecture.

curl https://api.tinylink.fr/v1/pages/P6ac40109381964/links \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964/links', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964/links');
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/pages/P6ac40109381964/links',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()

Réponses possibles

{
  "data": [
    {
      "id": "L6ac4011edb7c6",
      "title": "Mon site",
      "description": "",
      "url": "https://exemple.fr",
      "type": "url",
      "format": "LIST",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 1,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    },
    {
      "id": "L6ac4011eeb074",
      "title": "Mes réseaux",
      "description": "",
      "url": null,
      "type": "title",
      "format": "TITLE",
      "size": "FULL",
      "visible": true,
      "archived": false,
      "position": 2,
      "status": "active",
      "image": null,
      "created_at": "2026-10-05T21:57:18+02:00"
    }
  ]
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page 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."
  }
}

Ajouter un lien

POST/v1/pages/{id}/links

Ajoute un lien en bas de la page, ou plusieurs avec {"links": [ … ]} (100 au plus) : la réponse est alors {"data": [ … ]}. Les plafonds de liens de votre offre s'appliquent comme dans l'application. Portée Écriture.

title — obligatoire, sauf pour le format SOCIAL ; 100 caractères au plus
url — une adresse web, un e-mail ou un téléphone, avec ou sans mailto: / tel: ; inutile pour un TITLE
description — 1 000 caractères au plus
format — LIST (par défaut), BANNER, SQUARE, SOCIAL, ou TITLE pour un titre de section
size — FULL (par défaut) ou HALF, pour LIST, BANNER et SQUARE
visible — false pour l'ajouter masqué
position — rang dans la page, 1 = en haut

curl -X POST https://api.tinylink.fr/v1/pages/P6ac40109381964/links \
  -H "Authorization: Bearer tl_votre_jeton" \
  -H "Content-Type: application/json" \
  -d '{"title":"Mon site","url":"https://exemple.fr"}'

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964/links', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_votre_jeton',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'Mon site', url: 'https://exemple.fr' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964/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(['title' => 'Mon site', 'url' => 'https://exemple.fr']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/pages/P6ac40109381964/links',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
    json={'title': 'Mon site', 'url': 'https://exemple.fr'},
)
data = response.json()

Réponses possibles

{
  "id": "L6ac4011edb7c6",
  "title": "Mon site",
  "description": "",
  "url": "https://exemple.fr",
  "type": "url",
  "format": "LIST",
  "size": "FULL",
  "visible": true,
  "archived": false,
  "position": 1,
  "status": "active",
  "image": null,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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 par page de l'offre atteint

{
  "error": {
    "code": "plan_limit_reached",
    "message": "The plan allows 50 links per page (50 already used).",
    "details": {
      "max": 50,
      "used": 50
    }
  }
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page not found in this environment."
  }
}

Champ obligatoire absent ou vide

{
  "error": {
    "code": "validation_failed",
    "message": "The \"title\" field is required.",
    "details": {
      "field": "title"
    }
  }
}

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"
    }
  }
}

É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."
  }
}

Lire un lien

GET/v1/pages/{id}/links/{lien}

Un seul lien de la page, par son identifiant. Portée Lecture.

curl https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6 \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6');
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/pages/P6ac40109381964/links/L6ac4011edb7c6',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
data = response.json()

Réponses possibles

{
  "id": "L6ac4011edb7c6",
  "title": "Mon site",
  "description": "",
  "url": "https://exemple.fr",
  "type": "url",
  "format": "LIST",
  "size": "FULL",
  "visible": true,
  "archived": false,
  "position": 1,
  "status": "active",
  "image": null,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page not found in this environment."
  }
}

Aucun lien avec cet identifiant sur la page

{
  "error": {
    "code": "not_found",
    "message": "Link not found on this page."
  }
}

Plus de 120 requêtes dans la minute

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Modifier un lien

PATCH/v1/pages/{id}/links/{lien}

N'envoyez que les champs à changer : title, description, url, format, size, visible (masquer ou afficher), archived (archiver ou désarchiver) et position (déplacer). Un composant ou un bloc d'intégration ne peut qu'être masqué, archivé ou déplacé. Portée Écriture.

curl -X PATCH https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6 \
  -H "Authorization: Bearer tl_votre_jeton" \
  -H "Content-Type: application/json" \
  -d '{"title":"Mon site web","position":2,"visible":false}'

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer tl_votre_jeton',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'Mon site web', position: 2, visible: false }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6');
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(['title' => 'Mon site web', 'position' => 2, 'visible' => false]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.patch(
    'https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
    json={'title': 'Mon site web', 'position': 2, 'visible': False},
)
data = response.json()

Réponses possibles

{
  "id": "L6ac4011edb7c6",
  "title": "Mon site web",
  "description": "",
  "url": "https://exemple.fr",
  "type": "url",
  "format": "LIST",
  "size": "FULL",
  "visible": false,
  "archived": false,
  "position": 2,
  "status": "active",
  "image": null,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page not found in this environment."
  }
}

Aucun lien avec cet identifiant sur la page

{
  "error": {
    "code": "not_found",
    "message": "Link not found on this page."
  }
}

Aucun champ modifiable dans le corps

{
  "error": {
    "code": "validation_failed",
    "message": "Nothing to update. Accepted fields: title, description, url, format, size, visible, archived, position."
  }
}

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

DELETE/v1/pages/{id}/links/{lien}

Supprime le lien, son image et ses statistiques, puis renumérote les suivants. Portée Suppression.

curl -X DELETE https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6 \
  -H "Authorization: Bearer tl_votre_jeton"

const response = await fetch('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
console.log(response.status); // 204

$ch = curl_init('https://api.tinylink.fr/v1/pages/P6ac40109381964/links/L6ac4011edb7c6');
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/pages/P6ac40109381964/links/L6ac4011edb7c6',
    headers={'Authorization': 'Bearer tl_votre_jeton'},
)
print(response.status_code)  # 204

Ré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"
    }
  }
}

Aucune page avec cet identifiant ou ce slug dans l'environnement

{
  "error": {
    "code": "not_found",
    "message": "Page not found in this environment."
  }
}

Aucun lien avec cet identifiant sur la page

{
  "error": {
    "code": "not_found",
    "message": "Link not found on this page."
  }
}

Plus de 120 requêtes dans la minute

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Lister les pages

Créer une page

Lire une page

Modifier une page

Supprimer une page

Lister les liens d'une page

Ajouter un lien

Lire un lien

Modifier un lien

Supprimer un lien

Vous ne trouvez pas votre réponse ?