> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Mettre à jour un lien

> Mettre à jour les propriétés d'un lien existant

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 :**

```bash cURL theme={null}
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,
    "enable_conversion_tracking": true,
    "is_archived": false,
    "expiration_date": "2024-06-30T23:59:59Z",
    "expiration_click_count": 500,
    "pixel_id": "pixel_789123456"
  }'
```

**Réponse :**

```json theme={null}
{
  "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,
  "enable_conversion_tracking": true,
  "is_archived": false,
  "expiration_date": "2024-06-30T23:59:59Z",
  "expiration_click_count": 500,
  "clicks": 42
}
```

## Autorisation

<ParamField header="Authorization" type="string" required>
  Token Bearer pour l'authentification API. Format : `Bearer YOUR_API_KEY`
</ParamField>

## Paramètres de chemin

<ParamField path="link_id" type="string" required>
  Identifiant unique pour le link
</ParamField>

## 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

<ParamField body="name" type="string">
  Nom mis à jour pour le lien
</ParamField>

<ParamField body="description" type="string">
  Description mise à jour pour le lien
</ParamField>

<ParamField body="original_url" type="string">
  URL mise à jour à raccourcir. Prend en charge les schémas http, https, mailto, tel, sms, whatsapp, tg, skype.
</ParamField>

<ParamField body="code" type="string">
  Code court mis à jour pour le lien
</ParamField>

<ParamField body="pixel_id" type="string">
  ID du pixel de suivi mis à jour à associer avec ce lien
</ParamField>

<ParamField body="project_id" type="string">
  ID du projet mis à jour à associer avec ce lien
</ParamField>

### Paramètres de deep linking

<ParamField body="app" type="string">
  Nom mis à jour de l'application mobile pour le deep linking
</ParamField>

<ParamField body="app_logo" type="string">
  URL mise à jour vers l'image du logo de l'application
</ParamField>

<ParamField body="android_link" type="string">
  URL mise à jour de deep link Android (ex: myapp\://open?url=...)
</ParamField>

<ParamField body="ios_link" type="string">
  URL mise à jour de deep link iOS (ex: myapp\://open?url=...)
</ParamField>

<ParamField body="windows_link" type="string">
  URL mise à jour de deep link Windows (ex: ms-windows-store://...)
</ParamField>

<ParamField body="macos_link" type="string">
  URL mise à jour de deep link macOS (ex: macappstore://...)
</ParamField>

<ParamField body="whatsapp_message" type="string">
  Message pré-rempli mis à jour pour le partage WhatsApp
</ParamField>

### Paramètres de métadonnées

<ParamField body="metadata" type="object">
  Métadonnées de lien mises à jour pour les aperçus de site web

  <Expandable title="Propriétés des métadonnées">
    <ParamField body="title" type="string">
      Titre de page mis à jour pour les aperçus de lien
    </ParamField>

    <ParamField body="description" type="string">
      Description de page mise à jour pour les aperçus de lien
    </ParamField>

    <ParamField body="favicon" type="string">
      URL mise à jour vers l'image du favicon
    </ParamField>

    <ParamField body="social_image" type="string">
      URL mise à jour vers l'image d'aperçu des réseaux sociaux
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="qr_code_options" type="object">
  Options mises à jour de génération de code QR

  <Expandable title="Options du code QR">
    <ParamField body="size" type="integer">
      Taille mise à jour du code QR en pixels
    </ParamField>

    <ParamField body="color" type="string">
      Couleur mise à jour du code QR (format hex, ex: #000000)
    </ParamField>

    <ParamField body="background_color" type="string">
      Couleur de fond mise à jour du code QR (format hex, ex: #ffffff)
    </ParamField>

    <ParamField body="logo" type="string">
      URL mise à jour vers l'image du logo à intégrer dans le code QR
    </ParamField>

    <ParamField body="logo_size" type="integer">
      Taille mise à jour du logo en pixels
    </ParamField>

    <ParamField body="error_correction_level" type="string">
      Niveau de correction d'erreur mis à jour (L, M, Q, H)
    </ParamField>
  </Expandable>
</ParamField>

### Paramètres UTM

<ParamField body="utm_name" type="string">
  Nom mis à jour de la campagne UTM
</ParamField>

<ParamField body="utm_source" type="string">
  Source UTM mise à jour (ex: email, social, google)
</ParamField>

<ParamField body="utm_medium" type="string">
  Moyen UTM mis à jour (ex: newsletter, post, cpc)
</ParamField>

<ParamField body="utm_campaign" type="string">
  Identifiant mis à jour de campagne UTM
</ParamField>

<ParamField body="utm_term" type="string">
  Terme UTM mis à jour (mots-clés)
</ParamField>

<ParamField body="utm_content" type="string">
  Contenu UTM mis à jour (ex: cta\_button, banner)
</ParamField>

<ParamField body="utm_template_id" type="string">
  Identifiant mis à jour de modèle UTM
</ParamField>

<ParamField body="referrer" type="string">
  URL du référent mise à jour
</ParamField>

### Paramètres de sécurité et d'accès

<ParamField body="password" type="string">
  Mot de passe mis à jour pour protéger le lien (nécessite une fonctionnalité de plan)
</ParamField>

<ParamField body="password_description" type="string">
  Description mise à jour affichée lorsque le mot de passe est requis
</ParamField>

<ParamField body="excluded_countries" type="array">
  Tableau mis à jour des pays à exclure de l'accès au lien

  <Expandable title="Propriétés des pays exclus">
    <ParamField body="code" type="string" required>
      Code du pays (ISO 3166-1 alpha-2)
    </ParamField>

    <ParamField body="label" type="string" required>
      Nom du pays
    </ParamField>

    <ParamField body="phone" type="string" required>
      Code téléphonique du pays
    </ParamField>

    <ParamField body="suggested" type="boolean">
      Si ce pays est suggéré pour l'exclusion
    </ParamField>

    <ParamField body="lang" type="string">
      Code de langue principal
    </ParamField>

    <ParamField body="continent" type="string">
      Nom du continent
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="has_public_stat" type="boolean">
  Paramètre mis à jour pour savoir si les statistiques du lien sont publiquement accessibles
</ParamField>

### Paramètres de suivi de conversion

<ParamField body="enable_conversion_tracking" type="boolean">
  Paramètre mis à jour pour activer ou non le suivi de conversion sur ce lien
</ParamField>

### Paramètres de statut

<ParamField body="is_archived" type="boolean">
  Statut d'archivage mis à jour du lien
</ParamField>

### Paramètres d'expiration

<ParamField body="expiration_date" type="string">
  Date et heure ISO 8601 mises à jour d'expiration du lien (nécessite une fonctionnalité de plan)
</ParamField>

<ParamField body="expiration_click_count" type="integer">
  Nombre maximum mis à jour de clics avant l'expiration du lien (nécessite une fonctionnalité de plan)
</ParamField>
