Passer au contenu principal
Ce guide de démarrage rapide vous accompagnera pour faire votre premier appel API vers l’API taap.it.

​
Prérequis

Avant de commencer, vous aurez besoin de :
  • Un compte taap.it
  • Une clé API (créée via le tableau de bord web)
  • Un outil pour faire des requêtes HTTP (curl, Postman, ou votre client préféré)

​
Étape 1 : Créer une clé API

1

Se connecter au tableau de bord taap.it

Visitez www.taap.it et connectez-vous à votre compte.
2

Naviguer vers les paramètres API

Allez dans vos paramètres utilisateur et trouvez la section “Clés API”.
3

Générer une nouvelle clé

Cliquez sur “Créer une clé API” et donnez-lui un nom descriptif. Copiez la clé générée immédiatement.
Les clés API ne sont affichées qu’une seule fois lors de la création. Assurez-vous de les copier et de les stocker en sécurité.
Votre clé API ressemblera à ceci : taapit_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

​
Étape 2 : Faire votre première requête

Commençons par lister vos liens existants pour vérifier que votre clé API fonctionne :
cURL
curl -X GET 'https://api.taap.it/v1/links' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici' \
  -H 'Content-Type: application/json'
Réponse : 
{
  "items": [],
  "page": 1,
  "page_size": 20,
  "has_next": false
}

​
Étape 3 : Créer votre premier lien

Maintenant créons un lien raccourci :
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",
    "custom_code": "mon-lien-personnalise"
  }'
Réponse : 
{
  "id": "link_987654321",
  "original_url": "https://example.com/url-tres-longue-qui-a-besoin-detre-raccourcie",
  "short_url": "https://taap.it/mon-lien-personnalise",
  "code": "mon-lien-personnalise",
  "created_at": "2024-01-15T10:35:00Z",
  "updated_at": "2024-01-15T10:35:00Z",
  "click_count": 0,
  "is_active": true
}

​
Étape 4 : Obtenir les analyses de lien

Vérifions les analyses pour votre lien nouvellement créé :
cURL
curl -X GET 'https://api.taap.it/v1/stats/links/link_987654321' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici' \
  -H 'Content-Type: application/json'
Réponse : 
[
  {
    "link_id": "link_987654321",
    "click_date": "2024-01-15",
    "total_clicks": 0,
    "unique_visitors": 0,
    "country_stats": {},
    "device_stats": {},
    "browser_stats": {},
    "scans_only": 0
  }
]

​
Étapes suivantes

Explorer les domaines

Apprenez à gérer les domaines personnalisés pour vos liens raccourcis

Gestion de projets

Organisez vos liens en projets pour une meilleure gestion

Analyses avancées

Plongez plus profondément dans les performances des liens et analyses utilisateur

Gestion des liens

Créez, mettez à jour et gérez vos liens raccourcis

​
Modèles courants

​
Gestion d’erreurs

Vérifiez toujours les erreurs dans les réponses API :
Exemple JavaScript
const response = await fetch('https://api.taap.it/v1/links', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

if (!response.ok) {
  const error = await response.json();
  console.error('Erreur API:', error.detail);
  return;
}

const data = await response.json();
console.log('Succès:', data);

​
Gestion des limites de taux

Gérez les limites de taux avec élégance :
Exemple JavaScript
async function makeRequest(url, options) {
  const response = await fetch(url, options);
  
  if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    console.log(`Limite de taux atteinte. Réessayer après ${retryAfter} secondes`);
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
    return makeRequest(url, options); // Réessayer
  }
  
  return response;
}

​
Besoin d’aide ?

  • Vérifiez que votre clé API est correcte et active
  • Assurez-vous d’utiliser le préfixe Bearer dans l’en-tête Authorization
  • Vérifiez que votre clé API n’a pas expiré
  • Implémentez un backoff exponentiel pour les tentatives
  • Surveillez l’en-tête X-RateLimit-Remaining
  • Considérez la mise en cache des réponses pour réduire les appels API
  • 401 Non autorisé : Clé API invalide ou manquante
  • 403 Interdit : Permissions insuffisantes pour la ressource demandée
  • 404 Non trouvé : La ressource n’existe pas ou vous n’y avez pas accès
  • 409 Conflit : La ressource existe déjà (ex: code personnalisé dupliqué)

Prêt à construire ?

Explorez notre référence API complète pour débloquer toute la puissance de taap.it.