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

# Introduction

> Bienvenue dans la documentation de l'API taap.it

## Qu'est-ce que l'API taap.it ?

L'API taap.it fournit un accès programmatique à la plateforme de gestion de liens et d'analyse de taap.it. Avec notre API, vous pouvez créer, gérer et suivre des liens raccourcis, analyser les données de performance et intégrer les capacités de taap.it directement dans vos applications.

## Fonctionnalités principales

<CardGroup cols={2}>
  <Card title="Gestion des liens" icon="link">
    Créer, mettre à jour et supprimer des liens raccourcis avec domaines personnalisés et fonctionnalités avancées
  </Card>

  <Card title="Analyses et insights" icon="chart-line">
    Suivre les clics, visiteurs uniques, données géographiques et analyses d'appareils
  </Card>

  <Card title="Domaines personnalisés" icon="globe">
    Créer des liens courts de marque avec vos propres domaines personnalisés
  </Card>

  <Card title="Gestion de projets" icon="folder">
    Regrouper les liens associés et suivre les performances à travers les projets
  </Card>
</CardGroup>

## Commencer

<Steps>
  <Step title="Créer une clé API">
    Connectez-vous à votre tableau de bord taap.it et naviguez vers vos paramètres utilisateur pour créer une clé API.

    <Warning>
      Gardez votre clé API sécurisée et ne la partagez jamais publiquement. Les clés API fournissent un accès complet à votre compte.
    </Warning>
  </Step>

  <Step title="Faire votre première requête">
    Utilisez votre clé API pour authentifier les requêtes vers l'API taap.it.

    ```bash cURL theme={null}
    curl -X GET 'https://api.taap.it/v1/links' \
      -H 'Authorization: Bearer taapit_votre_cle_api_ici'
    ```
  </Step>

  <Step title="Commencer à construire">
    Explorez nos endpoints pour domaines, liens, projets et statistiques pour construire des intégrations puissantes.
  </Step>
</Steps>

## Authentification

Toutes les requêtes API nécessitent une authentification utilisant une clé API. Incluez votre clé API dans l'en-tête Authorization en utilisant le format Bearer token :

```bash theme={null}
Authorization: Bearer taapit_votre_cle_api_ici
```

<Info>
  Les clés API sont préfixées avec `taapit_` et peuvent être créées via le tableau de bord de l'application web.
</Info>

## URL de base

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

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

## Limites de taux

L'API taap.it implémente une limitation de taux pour assurer une utilisation équitable et des performances optimales :

* **Limites basées sur le plan** : Les limites de taux varient selon votre plan d'abonnement
* **Application par utilisateur** : Les limites sont appliquées par compte utilisateur
* **Futures limites spécifiques aux endpoints** : Peuvent être implémentées pour des endpoints spécifiques à l'avenir

Les en-têtes de limite de taux sont inclus dans toutes les réponses :

```http theme={null}
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
```

## Format de réponse

Toutes les réponses API sont retournées au format JSON avec la structure suivante :

<CodeGroup>
  ```json Réponse de succès theme={null}
  {
    "data": { ... },
    "message": "Success"
  }
  ```

  ```json Réponse d'erreur theme={null}
  {
    "detail": "Message d'erreur décrivant ce qui s'est mal passé"
  }
  ```
</CodeGroup>

## Codes de statut

L'API utilise les codes de statut HTTP standard :

* `200` - Succès
* `201` - Créé
* `400` - Mauvaise requête
* `401` - Non autorisé
* `403` - Interdit
* `404` - Non trouvé
* `409` - Conflit
* `429` - Trop de requêtes
* `500` - Erreur interne du serveur

## Support

Besoin d'aide ? Nous sommes là pour vous assister :

* **Email** : [support@taap.it](mailto:support@taap.it)
* **Documentation** : Ce site de documentation
* **Page de statut** : status.taap.it

<Card title="Prêt à commencer ?" icon="rocket" href="/fr/quickstart">
  Passez à notre guide de démarrage rapide pour faire votre premier appel API en moins de 5 minutes.
</Card>