Bêta privée. Discover est appelable dès aujourd'hui avec votre clé d'API habituelle, sur tous les forfaits y compris Founding, et décompte votre quota mensuel d'ops comme n'importe quel autre appel. Ce n'est ni annoncé ni disponible de façon générale : les formes de requête et de réponse peuvent changer sans préavis, et il n'y a aucun engagement de stabilité ni de support, donc ne construisez rien de critique dessus pour l'instant. La feuille de route est sur
Bientôt disponible, et chaque publication est annoncée dans
le changelog.
`POST /v2/discover` est une API de crawl de sitemap qui liste les URLs
d'un site à moindre coût : un crawl en priorité HTTP combiné à un
parsing de sitemap, avec un repli de rendu JavaScript optionnel pour les
applications monopage (SPA). Il n'y a ni capture d'écran, ni PDF, ni
artefact stocké. Elle renvoie une liste plate et dédupliquée
d'URLs ainsi qu'un décompte de la provenance de chacune, de façon
synchrone en un seul appel. Ce sera la primitive légère « cartographier
le site » : pointez-la vers un domaine, récupérez les pages qui
méritent d'être traitées, puis injectez cette liste dans
[l'endpoint perceive](/fr/docs/endpoints/perceive.md) ou dans un job d'ingestion en
mode crawl.
Voici l'appel minimal utile. Envoyez une URL, récupérez sa carte :
```bash
curl -X POST https://api.enconvert.com/v2/discover \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com"
}'
```
La réponse est une simple liste d'URLs avec des compteurs de
provenance. Il n'y a pas d'URLs signées, pas d'ID d'opération et pas de
polling :
```json
{
"url": "https://example.com",
"mode": "hybrid",
"total": 47,
"urls": [
"https://example.com/",
"https://example.com/pricing",
"https://example.com/docs",
"https://example.com/blog/launch"
],
"pages_crawled": 12,
"truncated": false,
"robots_respected": false,
"sources": {"sitemap": 42, "crawl": 30},
"warnings": []
}
```
---
## Endpoints
| Méthode | Chemin | Objectif |
|--------|------|---------|
| `POST` | `/v2/discover` | Cartographie les URLs d'un site en HTTP uniquement et renvoie une liste plate avec des compteurs par source. |
`/v2/discover` expose un seul chemin. Il est sans état : il n'y a
aucune ligne d'opération à récupérer ni aucun job à interroger, donc il
n'existe pas d'endpoint `GET` compagnon comme
[c'est le cas pour perceive](/fr/docs/endpoints/perceive.md).
**Content-Type :** `application/json` sur le `POST`.
---
## Authentification
Authentifiez-vous avec une clé privée dans l'en-tête `X-API-Key` pour
les appels serveur à serveur. C'est la voie utilisée par les exemples
ci-dessous.
```http
X-API-Key: sk_your_private_key
```
Les clés publiques avec un jeton bearer JWT fonctionnent également,
selon le même flux que tous les autres endpoints : générez un jeton
avec votre clé `pk_`, puis envoyez-le en tant que
`Authorization: Bearer