Passer au contenu principal
PUT
https://api.taap.it
/
v1
/
links
/
{id}
Mettre à jour un lien
curl --request PUT \
  --url https://api.taap.it/v1/links/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "original_url": "<string>",
  "code": "<string>",
  "pixel_id": "<string>",
  "app": "<string>",
  "app_logo": "<string>",
  "android_link": "<string>",
  "ios_link": "<string>",
  "windows_link": "<string>",
  "macos_link": "<string>",
  "whatsapp_message": "<string>",
  "metadata": {
    "title": "<string>",
    "description": "<string>",
    "favicon": "<string>",
    "social_image": "<string>"
  },
  "qr_code_options": {
    "size": 123,
    "color": "<string>",
    "background_color": "<string>",
    "logo": "<string>",
    "logo_size": 123,
    "error_correction_level": "<string>"
  },
  "utm_name": "<string>",
  "utm_source": "<string>",
  "utm_medium": "<string>",
  "utm_campaign": "<string>",
  "utm_term": "<string>",
  "utm_content": "<string>",
  "utm_template_id": "<string>",
  "referrer": "<string>",
  "password": "<string>",
  "password_description": "<string>",
  "excluded_countries": [
    {
      "code": "<string>",
      "label": "<string>",
      "phone": "<string>",
      "suggested": true,
      "lang": "<string>",
      "continent": "<string>"
    }
  ],
  "has_public_stat": true,
  "is_archived": true,
  "expiration_date": "<string>",
  "expiration_click_count": 123
}
'
Mettre à jour les propriétés d’un lien existant incluant l’URL, le mot de passe et les paramètres d’expiration. Requête :
cURL
curl -X PUT 'https://api.taap.it/v1/links/link_987654321' \
  -H 'Authorization: Bearer taapit_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated Marketing Link",
    "description": "Updated description for campaign",
    "original_url": "https://example.com/updated-url",
    "code": "updated-code",
    "app": "UpdatedApp",
    "app_logo": "https://example.com/new-logo.png",
    "android_link": "updatedapp://open?url=https://example.com",
    "ios_link": "updatedapp://open?url=https://example.com",
    "windows_link": "ms-windows-store://pdp/?productid=9NBLGGH987654",
    "macos_link": "macappstore://itunes.apple.com/app/updatedapp/id987654321",
    "whatsapp_message": "Check out this updated link!",
    "metadata": {
      "title": "Updated Product",
      "description": "Check out our updated product",
      "favicon": "https://example.com/new-favicon.ico",
      "social_image": "https://example.com/new-social-image.jpg"
    },
    "qr_code_options": {
      "size": 250,
      "color": "#FF0000",
      "background_color": "#FFFFFF",
      "logo": "https://example.com/new-logo.png",
      "logo_size": 60,
      "error_correction_level": "H"
    },
    "utm_name": "updated_campaign",
    "utm_source": "social",
    "utm_medium": "facebook",
    "utm_campaign": "updated2024",
    "utm_term": "updated_marketing",
    "utm_content": "updated_cta_button",
    "utm_template_id": "template_456",
    "referrer": "https://facebook.com",
    "password": "newpassword123",
    "password_description": "Enter new password to access link",
    "excluded_countries": [
      {
        "code": "CA",
        "label": "Canada",
        "phone": "+1",
        "suggested": false,
        "lang": "en",
        "continent": "North America"
      }
    ],
    "has_public_stat": false,
    "is_archived": false,
    "expiration_date": "2024-06-30T23:59:59Z",
    "expiration_click_count": 500,
    "pixel_id": "pixel_789123456"
  }'
Réponse : 
{
  "id": "link_987654321",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T11:00:00Z",
  "project_id": "project_123456789",
  "domain_id": "domain_987654321",
  "pixel_id": "pixel_789123456",
  "original_url": "https://example.com/updated-url",
  "name": "Updated Marketing Link",
  "description": "Updated description for campaign",
  "code": "updated-code",
  "app": "UpdatedApp",
  "app_logo": "https://example.com/new-logo.png",
  "android_link": "updatedapp://open?url=https://example.com",
  "ios_link": "updatedapp://open?url=https://example.com",
  "windows_link": "ms-windows-store://pdp/?productid=9NBLGGH987654",
  "macos_link": "macappstore://itunes.apple.com/app/updatedapp/id987654321",
  "whatsapp_message": "Check out this updated link!",
  "metadata": {
    "title": "Updated Product",
    "description": "Check out our updated product",
    "favicon": "https://example.com/new-favicon.ico",
    "social_image": "https://example.com/new-social-image.jpg"
  },
  "qr_code_options": {
    "size": 250,
    "color": "#FF0000",
    "background_color": "#FFFFFF",
    "logo": "https://example.com/new-logo.png",
    "logo_size": 60,
    "error_correction_level": "H"
  },
  "utm_name": "updated_campaign",
  "utm_source": "social",
  "utm_medium": "facebook",
  "utm_campaign": "updated2024",
  "utm_term": "updated_marketing",
  "utm_content": "updated_cta_button",
  "utm_template_id": "template_456",
  "referrer": "https://facebook.com",
  "password": "newpassword123",
  "password_description": "Enter new password to access link",
  "excluded_countries": [
    {
      "code": "CA",
      "label": "Canada",
      "phone": "+1",
      "suggested": false,
      "lang": "en",
      "continent": "North America"
    }
  ],
  "has_public_stat": false,
  "is_archived": false,
  "expiration_date": "2024-06-30T23:59:59Z",
  "expiration_click_count": 500,
  "clicks": 42
}

​
Autorisation

​
Authorization
string
required
Token Bearer pour l’authentification API. Format : Bearer YOUR_API_KEY

​
Paramètres de chemin

​
link_id
string
required
Identifiant unique pour le link

​
Corps de la requête

Tous les paramètres sont optionnels pour les mises à jour. Incluez uniquement les champs que vous souhaitez mettre à jour.

​
Paramètres principaux

​
name
string
Nom mis à jour pour le lien
​
description
string
Description mise à jour pour le lien
​
original_url
string
URL mise à jour à raccourcir. Prend en charge les schémas http, https, mailto, tel, sms, whatsapp, tg, skype.
​
code
string
Code court mis à jour pour le lien
​
pixel_id
string
ID du pixel de suivi mis à jour à associer avec ce lien

​
Paramètres de deep linking

​
app
string
Nom mis à jour de l’application mobile pour le deep linking
URL mise à jour vers l’image du logo de l’application
​
android_link
string
URL mise à jour de deep link Android (ex: myapp://open?url=…)
​
ios_link
string
URL mise à jour de deep link iOS (ex: myapp://open?url=…)
​
windows_link
string
URL mise à jour de deep link Windows (ex: ms-windows-store://…)
​
macos_link
string
URL mise à jour de deep link macOS (ex: macappstore://…)
​
whatsapp_message
string
Message pré-rempli mis à jour pour le partage WhatsApp

​
Paramètres de métadonnées

​
metadata
object
Métadonnées de lien mises à jour pour les aperçus de site web
​
qr_code_options
object
Options mises à jour de génération de code QR

​
Paramètres UTM

​
utm_name
string
Nom mis à jour de la campagne UTM
​
utm_source
string
Source UTM mise à jour (ex: email, social, google)
​
utm_medium
string
Moyen UTM mis à jour (ex: newsletter, post, cpc)
​
utm_campaign
string
Identifiant mis à jour de campagne UTM
​
utm_term
string
Terme UTM mis à jour (mots-clés)
​
utm_content
string
Contenu UTM mis à jour (ex: cta_button, banner)
​
utm_template_id
string
Identifiant mis à jour de modèle UTM
​
referrer
string
URL du référent mise à jour

​
Paramètres de sécurité et d’accès

​
password
string
Mot de passe mis à jour pour protéger le lien (nécessite une fonctionnalité de plan)
​
password_description
string
Description mise à jour affichée lorsque le mot de passe est requis
​
excluded_countries
array
Tableau mis à jour des pays à exclure de l’accès au lien
​
has_public_stat
boolean
Paramètre mis à jour pour savoir si les statistiques du lien sont publiquement accessibles

​
Paramètres de statut

​
is_archived
boolean
Statut d’archivage mis à jour du lien

​
Paramètres d’expiration

​
expiration_date
string
Date et heure ISO 8601 mises à jour d’expiration du lien (nécessite une fonctionnalité de plan)
​
expiration_click_count
integer
Nombre maximum mis à jour de clics avant l’expiration du lien (nécessite une fonctionnalité de plan)