> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spottracker.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

> Lire vos entreprises identifiées, leurs décideurs et vos leads qualifiés depuis vos propres outils.

L'API SpotTracker vous donne accès, depuis vos propres outils, aux données que
l'application affiche : les entreprises identifiées sur votre site, les
décideurs qui y sont rattachés, et les comptes que le moteur de qualification
fait remonter en priorité.

<Note>
  L'accès API est inclus à partir de l'offre **Growth**. Sur l'offre Starter,
  la création de clé est refusée. [Voir les offres](https://www.spottracker.fr/tarifs)
</Note>

<Card title="Première fois ? Commencez par l'authentification" icon="key" href="/authentification" horizontal>
  Comment créer une clé, où la ranger, et ce qu'elle donne exactement.
</Card>

## Ce qu'elle permet

<CardGroup cols={2}>
  <Card title="Entreprises identifiées" icon="building" href="/pagination">
    La liste de vos visiteurs identifiés, avec leur score d'intention, leur
    fiche firmographique et leurs contacts.
  </Card>

  <Card title="Leads qualifiés" icon="bolt">
    Les comptes prioritaires, avec le signal qui les a fait remonter et
    l'action recommandée.
  </Card>

  <Card title="Synchronisation incrémentale" icon="arrows-rotate" href="/pagination">
    Le paramètre `since` ne renvoie que ce qui a bougé : de quoi alimenter un
    entrepôt ou un CRM sans tout relire.
  </Card>

  <Card title="Vérification de clé" icon="key" href="/authentification">
    `GET /v1/me` répond « cette clé est valide et vise ce workspace », sans
    consommer de données.
  </Card>
</CardGroup>

## Ce qu'elle ne permet pas

L'API est **en lecture seule**. Elle ne crée, ne modifie et ne supprime rien.
Pour pousser des données vers un CRM ou un canal de notification, utilisez les
connecteurs de l'application plutôt qu'un script maison : ils gèrent la
correspondance des champs et les rejeux.

## Principes

<Steps>
  <Step title="Une clé, un workspace">
    La clé porte le workspace. Aucune route ne lit un identifiant de workspace
    depuis la requête, et il n'existe donc aucun moyen de viser les données
    d'un autre espace de travail avec votre clé.
  </Step>

  <Step title="Refus par défaut">
    Toute anomalie d'authentification renvoie `401`, sans préciser laquelle.
    C'est délibéré — voir [Erreurs](/erreurs).
  </Step>

  <Step title="Stable et versionnée">
    Le préfixe `/v1` ne changera pas de forme sans nouvelle version. Des champs
    peuvent être **ajoutés** à une réponse : votre code doit ignorer ceux qu'il
    ne connaît pas.
  </Step>
</Steps>

<Card title="Commencer" icon="play" href="/demarrage-rapide" horizontal>
  Créer une clé et faire votre premier appel en moins de cinq minutes.
</Card>
