Passer au contenu principal
POST
/
v1
/
links
Créer un lien
curl --request POST \
  --url https://api.taap.it/v1/links \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "original_url": "<string>"
}
'
{
  "detail": "Format d'URL invalide"
}

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.

Créer un nouveau deeplink avec codes personnalisés, domaines, protection par mot de passe, dates d’expiration et fonctionnalités de suivi. Requête :
cURL
curl -X POST 'https://api.taap.it/v1/links' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici' \
  -H 'Content-Type: application/json' \
  -d '{
    "original_url": "https://example.com/url-tres-longue-qui-a-besoin-detre-raccourcie"
  }'
Réponse : 
{
  "id": "link_987654321",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "project_id": "project_123456789",
  "domain_id": "domain_987654321",
  "pixel_id": "pixel_456789123",
  "original_url": "https://example.com/url-tres-longue-qui-a-besoin-detre-raccourcie",
  "name": "Mon lien marketing",
  "description": "Lien pour la campagne d'\''été",
  "code": "ete2024",
  "app": "MonApp",
  "app_logo": "https://example.com/logo.png",
  "android_link": "monapp://open?url=https://example.com",
  "ios_link": "monapp://open?url=https://example.com",
  "windows_link": "ms-windows-store://pdp/?productid=9NBLGGH123456",
  "macos_link": "macappstore://itunes.apple.com/app/monapp/id123456789",
  "whatsapp_message": "Découvrez ce lien incroyable !",
  "metadata": {
    "title": "Produit incroyable",
    "description": "Découvrez notre nouveau produit",
    "favicon": "https://example.com/favicon.ico",
    "social_image": "https://example.com/social-image.jpg"
  },
  "qr_code_options": {
    "size": 200,
    "color": "#000000",
    "background_color": "#ffffff",
    "logo": "https://example.com/logo.png",
    "logo_size": 50,
    "error_correction_level": "M"
  },
  "utm_name": "campagne_ete",
  "utm_source": "email",
  "utm_medium": "newsletter",
  "utm_campaign": "ete2024",
  "utm_term": "marketing",
  "utm_content": "bouton_cta",
  "utm_template_id": "template_123",
  "referrer": "https://example.com",
  "password": "secure123",
  "password_description": "Entrez le mot de passe pour accéder au lien",
  "excluded_countries": [
    {
      "code": "US",
      "label": "États-Unis",
      "phone": "+1",
      "suggested": true,
      "lang": "en",
      "continent": "Amérique du Nord"
    }
  ],
  "has_public_stat": true,
  "is_archived": false,
  "expiration_date": "2024-12-31T23:59:59Z",
  "expiration_click_count": 1000,
  "clicks": 0
}

​
Autorisation

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

​
Paramètres de requête

​
original_url
string
requis
L’URL à raccourcir. Supporte les schémas http, https, mailto, tel, sms, whatsapp, tg, skype.

​
Champs de réponse

​
Champs principaux

​
id
string
requis
Identifiant unique pour le lien créé
​
created_at
string
requis
Horodatage ISO 8601 de création du lien
​
updated_at
string
requis
Horodatage ISO 8601 de dernière mise à jour du lien
​
project_id
string
ID du projet associé
​
domain_id
string
ID du domaine personnalisé utilisé
​
pixel_id
string
ID du pixel de suivi associé

​
Contenu du lien

​
original_url
string
requis
L’URL originale qui a été raccourcie
​
name
string
Nom du lien
​
description
string
Description du lien
​
code
string
requis
Le code court utilisé dans l’URL

​
Deep linking

​
app
string
Nom de l’application mobile pour le deep linking
URL vers l’image du logo de l’application
​
android_link
string
URL de deep link Android
​
ios_link
string
URL de deep link iOS
​
windows_link
string
URL de deep link Windows
​
macos_link
string
URL de deep link macOS
​
whatsapp_message
string
Message pré-rempli pour le partage WhatsApp

​
Métadonnées et code QR

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

​
Paramètres UTM

​
utm_name
string
Nom de la campagne UTM
​
utm_source
string
Source UTM
​
utm_medium
string
Moyen UTM
​
utm_campaign
string
Identifiant de campagne UTM
​
utm_term
string
Terme UTM (mots-clés)
​
utm_content
string
Contenu UTM
​
utm_template_id
string
Identifiant de modèle UTM
​
referrer
string
URL du référent

​
Sécurité et accès

​
password
string
Mot de passe pour protéger le lien
​
password_description
string
Description affichée quand un mot de passe est requis
​
excluded_countries
array
Tableau des pays exclus de l’accès au lien
​
has_public_stat
boolean
Si les statistiques du lien sont publiquement accessibles

​
Drapeaux de statut

​
is_archived
boolean
Si le lien est archivé

​
Expiration

​
expiration_date
string
Date et heure ISO 8601 d’expiration du lien
​
expiration_click_count
integer
Nombre maximum de clics avant expiration du lien

​
Analytics

​
clicks
integer
Nombre total de clics

​
Réponses d’erreur

{
  "detail": "Format d'URL invalide"
}