# Démarrage rapide

> Première requête à l'API publique FanConvert, en curl, JavaScript et Python.

URL : https://docs.fanconvert.ai/fr/api/rest/demarrage

L'API publique lit vos créatrices, conversations, fans, ventes, statistiques, scripts, médias et urgences, avec le même cloisonnement que le dashboard. Elle ne peut **jamais envoyer un message à un fan**.

Adresse de base : `https://app.fanconvert.ai/public/v1`

## 1. Créer une clé [#1-créer-une-clé]

Dans FanConvert : **Réglages › API & MCP › Nouvelle clé**, en choisissant **Connecter un outil ou un développeur (API)**. Détail : [Créer une clé](/fr/api/cles). Gardez-la dans une variable d'environnement, jamais dans le code.

## 2. Première requête [#2-première-requête]

`GET /me` décrit la clé utilisée : ses créatrices, ses droits, son expiration.

```bash
curl https://app.fanconvert.ai/public/v1/me \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

```json
{
  "keyId": "3f1c…",
  "organizationId": "org_…",
  "scopes": ["creators:read", "statistics:read"],
  "creatorIds": ["emma-demo"],
  "expiresAt": "2026-12-07T05:40:00Z"
}
```

## 3. Lister vos créatrices [#3-lister-vos-créatrices]

<Tabs items={['curl', 'JavaScript', 'Python']}>
<Tab value="curl">

```bash
curl https://app.fanconvert.ai/public/v1/creators \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

</Tab>
<Tab value="JavaScript">

```js
const res = await fetch("https://app.fanconvert.ai/public/v1/creators", {
  headers: { Authorization: `Bearer ${process.env.FANCONVERT_API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).detail);
const { items } = await res.json();
```

</Tab>
<Tab value="Python">

```python
import os, requests

r = requests.get(
    "https://app.fanconvert.ai/public/v1/creators",
    headers={"Authorization": f"Bearer {os.environ['FANCONVERT_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json()["items"])
```

</Tab>
</Tabs>

## Ensuite [#ensuite]

- [Authentification et droits](/fr/api/rest/authentification)
- [Pagination](/fr/api/rest/pagination), [Erreurs](/fr/api/rest/erreurs), [Limites](/fr/api/rest/limites)
- [Webhooks](/fr/api/rest/webhooks) : recevoir les ventes sans interroger l'API
- [Référence complète](/fr/api/reference)