API de raccourcissement de liens Linkly

Créez, mettez à jour et gérez les liens par programme à l'aide de l'API de raccourcissement de liens de Linkly.

Connexes : API Analytics | Webhooks

Avant de commencer

Linkly génère les demandes d'API dans l'interface pour que vous les copiiez et les colliez dans vos applications.

Cela fonctionne pour la création de liens et la mise à jour de liens.

Économisez du temps et laissez-nous faire le travail difficile :

1. 1
   Voir ci-dessous pour les demandes d'API de création de liens.
2. 2
   Copiez les demandes dans leur intégralité. Vous pouvez vérifier qu'elles fonctionnent pour vous.
3. 3
   Demandez à ChatGPT ou équivalent d'adapter ces demandes en code source pour votre application. Il n'est pas nécessaire de passer du temps à faire une intégration complexe. Notre API est entièrement consommable par machine.

---

Spécification OpenAPI 3.0

Vous pouvez générer les demandes d'API directement à partir de l'interface utilisateur de Linkly.

L'API de Linkly est documentée à l'aide de la norme OpenAPI, qui va au-delà de ce qui est fourni ci-dessous. Les mêmes points de terminaison sont également disponibles en tant que collection Postman en un clic.

Voir la spécification OpenAPI

Exécuter dans Postman

Autorisation

Vous aurez besoin de :

• Votre clé API
• ID de l'espace de travail

Vous pouvez obtenir ces détails à l'intérieur de Linkly.

1. 1
   Connectez-vous à Linkly.
2. 2
   Cliquez sur Paramètres.
3. 3
   Cliquez sur Clés API.

Créer ou mettre à jour un lien

Pour créer un lien, il vous suffit d'envoyer une demande POST à :

https://app.linklyhq.com/api/v1/link

avec les champs suivants dans le corps.

Le type d'encodage est x-www-form-urlencoded ou application/json.

Si vous envoyez le champ Rules, vous devez utiliser application/json.

Nous vous recommandons d'utiliser JSON avec la spécification Open API.

Exemple de demande utilisant cURL

Le code ci-dessous illustre comment faire une demande d'API pour créer un lien.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

Une réponse réussie retournera un objet JSON représentant le lien, ainsi qu'un ID de lien.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

Mise à jour d'un lien

Pour mettre à jour un lien, envoyez la même demande que vous utiliseriez pour créer le lien, mais incluez le champ id pour le lien que vous souhaitez mettre à jour, ainsi que les modifications.

Création de rotateurs via API

Pour créer un rotateur, soumettez un champ appelé rules en tant que tableau JSON, ainsi que la charge utile du lien ci-dessus. Vous devez utiliser application/json pour envoyer les tableaux JSON.

Par exemple :

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

Création de redirections géo via API

Pour rediriger par pays, soumettez un champ appelé rules en tant que tableau JSON, ainsi que la charge utile du lien ci-dessus. Vous devez utiliser l'encodage application/json pour envoyer les tableaux JSON.

Par exemple :

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

Le pays est le code pays ISO 3166 alpha-2.

Création de redirections d'appareil via API

Pour rediriger par appareil, soumettez un champ appelé rules en tant que tableau JSON, ainsi que la charge utile du lien ci-dessus.

Par exemple :

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

Où le champ matches est l'un des suivants :

• ios
• android
• windows
• linux
• mac

Création ou mise à jour de plusieurs liens en une seule demande

Linkly prend en charge la création/modification de jusqu'à 1000 liens par demande.

Pour ce faire, soumettez votre clé API dans la demande comme suit :

https://app.linklyhq.com/api/v1/link?api_key=XXXXXXXXXXX

Ensuite, utilisez le même schéma que ci-dessus pour les cas individuels de liens, mais enveloppez les demandes de liens dans un tableau, de la forme :

[{link}, {link}]

Voici une demande complète qui mettra à jour deux liens :

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/workspace/WORKSPACE_ID/links?api_key=API_KEY'

Cela fonctionne pour les actions de création et de mise à jour.

Veuillez noter que cela peut prendre jusqu'à 60 secondes pour une demande importante. Si les demandes prennent plus longtemps, elles échoueront et vous devriez envisager de diviser votre charge de travail en chunks plus petits.

Limites de débit

L'API de raccourcissement de liens est limitée à 20 demandes/seconde. Jusqu'à 200 demandes par seconde sont disponibles sur demande. Vous pouvez télécharger jusqu'à 1000 liens dans une seule demande.

Connexes

• API Analytics - Exporter les données de clics et les rapports de trafic
• Webhooks - Notifications de clic en temps réel
• Intégration Zapier - Intégrations sans code