Passer au contenu principal
POST
https://api.taap.it
/
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"
}
Créer un nouveau lien raccourci 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
required
Token Bearer pour l’authentification API. Format : Bearer YOUR_API_KEY

​
Paramètres de requête

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

​
Champs de réponse

​
Champs principaux

​
id
string
required
Identifiant unique pour le lien créé
​
created_at
string
required
Horodatage ISO 8601 de création du lien
​
updated_at
string
required
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
required
L’URL originale qui a été raccourcie
​
name
string
Nom du lien
​
description
string
Description du lien
​
code
string
required
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"
}