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

# Documentation API taap.it

> API puissante de gestion de liens et d'analyse pour les développeurs

# Bienvenue sur l'API taap.it

L'**API taap.it** fournit un accès programmatique puissant à notre plateforme de gestion de liens et d'analyse. Créez, gérez et suivez des liens raccourcis avec des fonctionnalités de niveau entreprise et des analyses détaillées.

<CardGroup cols={2}>
  <Card title="Démarrage rapide" icon="rocket" href="/fr/quickstart">
    Lancez-vous avec votre premier appel API en moins de 5 minutes
  </Card>

  <Card title="Authentification" icon="key" href="/fr/authentication">
    Authentification sécurisée par clé API avec permissions granulaires
  </Card>

  <Card title="Référence API" icon="code" href="/fr/api-reference/links/create">
    Documentation complète pour tous les endpoints et fonctionnalités
  </Card>

  <Card title="Analyses" icon="chart-line" href="/fr/api-reference/stats/link-stats">
    Insights détaillés et métriques de performance pour vos liens
  </Card>
</CardGroup>

## Fonctionnalités clés

<AccordionGroup>
  <Accordion title="Gestion des liens" icon="link">
    * Créer des liens raccourcis avec codes et domaines personnalisés
    * Protection par mot de passe et paramètres d'expiration
    * Modèles de paramètres UTM et pixels de suivi
    * Opérations en lot et filtrage avancé
  </Accordion>

  <Accordion title="Analyses et insights" icon="chart-bar">
    * Suivi des clics en temps réel et comptage des visiteurs uniques
    * Analyses géographiques et par appareil
    * Statistiques de navigateur et de référent
    * Rapports exportables et visualisation de données
  </Accordion>

  <Accordion title="Fonctionnalités avancées" icon="cog">
    * Protection par mot de passe et paramètres d'expiration
    * Suivi des paramètres UTM et modèles
    * Génération de codes QR avec marque personnalisée
    * Restrictions géographiques et contrôle d'accès
  </Accordion>

  <Accordion title="Domaines personnalisés" icon="globe">
    * Liens courts avec votre domaine de marque
    * Vérification DNS et assistance à la configuration
    * Gestion des certificats SSL
    * Surveillance des performances de domaine
  </Accordion>
</AccordionGroup>

## Endpoints API populaires

<CardGroup cols={1}>
  <Card title="API Links" icon="link" href="/fr/api-reference/links/create">
    **POST /v1/links** - Créer, mettre à jour et gérer des liens raccourcis avec des fonctionnalités avancées comme la protection par mot de passe et les dates d'expiration.
  </Card>

  <Card title="API Analytics" icon="chart-line" href="/fr/api-reference/stats/link-stats">
    **GET /v1/stats/links/{id}** - Accéder à des analyses complètes incluant les clics, données géographiques et statistiques d'appareils.
  </Card>

  <Card title="API Domaines" icon="globe" href="/fr/api-reference/domains/create">
    **POST /v1/domains** - Gérer les domaines personnalisés pour les liens courts de marque avec vérification DNS.
  </Card>

  <Card title="API Projets" icon="folder" href="/fr/api-reference/projects/create">
    **POST /v1/projects** - Organiser et regrouper les liens associés avec une gestion basée sur les projets.
  </Card>
</CardGroup>

## Exemple rapide

<CodeGroup>
  ```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-longue",
      "custom_code": "mon-lien"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.taap.it/v1/links', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      original_url: 'https://example.com/url-longue',
      custom_code: 'mon-lien'
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
    'https://api.taap.it/v1/links',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json={
      'original_url': 'https://example.com/url-longue',
      'custom_code': 'mon-lien'
    }
  )
  ```
</CodeGroup>

**Réponse :**

```json theme={null}
{
  "id": "link_987654321",
  "original_url": "https://example.com/url-longue",
  "short_url": "https://taap.it/mon-lien",
  "code": "mon-lien",
  "created_at": "2024-01-15T10:30:00Z",
  "click_count": 0,
  "is_active": true
}
```

## URL de base et authentification

Toutes les requêtes API doivent être faites vers :

```
https://api.taap.it/v1
```

<Info>
  Toutes les requêtes nécessitent une authentification par clés API. Incluez votre clé API dans l'en-tête Authorization : `Bearer taapit_votre_cle_api_ici`
</Info>

<Card title="Prêt à commencer ?" icon="rocket" href="/fr/quickstart">
  Suivez notre guide de démarrage rapide pour faire votre premier appel API et commencer à construire avec taap.it.
</Card>