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

# Guide de démarrage rapide

> Lancez-vous avec l'API taap.it en quelques minutes

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

<Steps>
  <Step title="Se connecter au tableau de bord taap.it">
    Visitez [www.taap.it](https://www.taap.it) et connectez-vous à votre compte.
  </Step>

  <Step title="Naviguer vers les paramètres API">
    Allez dans vos paramètres utilisateur et trouvez la section "Clés API".
  </Step>

  <Step title="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.

    <Warning>
      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é.
    </Warning>
  </Step>
</Steps>

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 :

```bash cURL theme={null}
curl -X GET 'https://api.taap.it/v1/links' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici' \
  -H 'Content-Type: application/json'
```

**Réponse :**

```json theme={null}
{
  "items": [],
  "page": 1,
  "page_size": 20,
  "has_next": false
}
```

## Étape 3 : Créer votre premier lien

Maintenant créons un deeplink :

```bash cURL theme={null}
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 :**

```json theme={null}
{
  "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éé :

```bash cURL theme={null}
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 :**

```json theme={null}
[
  {
    "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

<CardGroup cols={2}>
  <Card title="Explorer les domaines" icon="globe" href="/fr/api-reference/domains/create">
    Apprenez à gérer les domaines personnalisés pour vos liens raccourcis
  </Card>

  <Card title="Gestion de projets" icon="folder" href="/fr/api-reference/projects/create">
    Organisez vos liens en projets pour une meilleure gestion
  </Card>

  <Card title="Analyses avancées" icon="chart-line" href="/fr/api-reference/stats/link-stats">
    Plongez plus profondément dans les performances des liens et analyses utilisateur
  </Card>

  <Card title="Gestion des liens" icon="link" href="/fr/api-reference/links">
    Créez, mettez à jour et gérez vos liens raccourcis
  </Card>
</CardGroup>

## Modèles courants

### Gestion d'erreurs

Vérifiez toujours les erreurs dans les réponses API :

```javascript Exemple JavaScript theme={null}
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 :

```javascript Exemple JavaScript theme={null}
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 ?

<AccordionGroup>
  <Accordion title="Problèmes d'authentification">
    * 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é
  </Accordion>

  <Accordion title="Limitation de taux">
    * 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
  </Accordion>

  <Accordion title="Erreurs courantes">
    * **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é)
  </Accordion>
</AccordionGroup>

<Card title="Prêt à construire ?" icon="code" href="/fr/api-reference/links/create">
  Explorez notre référence API complète pour débloquer toute la puissance de taap.it.
</Card>