Beta privata. Discover è già chiamabile oggi con la tua normale chiave API, su qualsiasi piano compreso Founding, e scala dalla tua quota mensile di ops come ogni altra chiamata. Non è annunciato né disponibile in generale: le forme di richiesta e risposta possono cambiare senza preavviso e non c'è alcun impegno di stabilità o di supporto, quindi non costruirci ancora sopra nulla di critico. La roadmap è su
In arrivo, e ogni rilascio viene annunciato nel
changelog.
`POST /v2/discover` è un'API di sitemap crawling che elenca gli URL di un
sito in modo economico: una scansione HTTP-first più il parsing della
sitemap, con un fallback opzionale di rendering JavaScript per le
single-page app. Non c'è alcuno screenshot, alcun PDF né alcun artefatto
salvato. Restituisce un elenco piatto e deduplicato
di URL con un conteggio di provenienza per ciascuno, in modo sincrono in
un'unica chiamata. Sarà la primitiva leggera per "mappare il sito":
puntala a un dominio, ottieni le pagine che vale la pena elaborare, poi
passa quell'elenco all'[endpoint perceive](/it/docs/endpoints/perceive.md) oppure a
un job di ingest in modalità crawl.
Ecco la chiamata minima utile. Invia un URL, ricevi la sua mappa:
```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 risposta è un semplice elenco di URL con contatori di provenienza.
Non ci sono URL firmati, né ID operazione, né 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
| Metodo | Percorso | Scopo |
|--------|------|---------|
| `POST` | `/v2/discover` | Mappa gli URL di un sito solo via HTTP e restituisce un elenco piatto con i conteggi per fonte. |
`/v2/discover` espone un solo percorso. È stateless: non c'è una riga di
operazione da recuperare né un job da interrogare, quindi non esiste un
endpoint `GET` di supporto come [avviene per perceive](/it/docs/endpoints/perceive.md).
**Content-Type:** `application/json` sulla `POST`.
---
## Autenticazione
Autenticati con una chiave privata nell'header `X-API-Key` per le
chiamate server-to-server. È il percorso usato negli esempi qui sotto.
```http
X-API-Key: sk_your_private_key
```
Funzionano anche le chiavi pubbliche con un token bearer JWT, usando lo
stesso flusso di ogni altro endpoint: genera un token con la tua chiave
`pk_`, poi invialo come `Authorization: Bearer