# Stato esportazione Felo

GET /api/v1/data/ppts/{business_id}/export

Genera una presentazione in modo asincrono, poi esporta un file PPTX. Mantieni separati i passaggi di generazione ed esportazione: un task creato non è ancora un file completato.

Tutti gli esempi usano `FELO_API_KEY` dalla [panoramica](https://openapi.felo.ai/it/docs/data-api/guides/felo-overview.md). Le chiamate usano **il saldo della piattaforma**, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.



Usa gli identificatori restituiti quando crei il task. Imposta `TASK_ID` su `task_id` e `PPT_ID` su `ppt_business_id`; anche `{business_id}` significa `ppt_business_id`.

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



## 5. Interroga l'esportazione e scarica

`GET /api/v1/data/ppts/{business_id}/export`

```bash
curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

| Stato | Azione successiva |
|---|---|
| `NOT_STARTED` | Invia l'esportazione una volta |
| `PROCESSING` | Attendi, poi interroga di nuovo con GET |
| `COMPLETED` | Leggi `download_url` e scarica il file |
| `FAILED` | Esamina l'errore e lo stato del task prima di inviare una nuova esportazione |

```json
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}
```

L'URL di esempio è illustrativo. Usa l'URL firmato effettivo restituito dalla risposta. È valido per **30 minuti**; lo stato di esportazione GET può restituire un link تازه mentre la presentazione rimane disponibile. Salva il file entro la sua durata di validità. Non inviare la tua chiave API Felo all'host di download del file.



## Durata, proprietà e fatturazione

- Le presentazioni scadono **sette giorni dopo la creazione**. Le query e le esportazioni non estendono questo periodo. L'`expires_at` della presentazione e l'`expires_at` dell'URL di download firmato descrivono durate diverse.
- Solo l'account API che ha creato la presentazione può accedere ai propri task e presentazioni. Una risorsa mancante o non accessibile può restituire 404; una risorsa scaduta o eliminata può restituire 410, oppure 404 dopo la pulizia.
- La generazione è fatturata per pagina generata (`ppt.generate`). Con la tariffazione per pagina, la creazione riserva il prezzo di dieci pagine, poi effettua il saldo dell'output effettivamente riuscito e libera la riserva inutilizzata. Il tuo account deve avere saldo disponibile sufficiente per la riserva anche se il prompt richiede meno pagine.
- L'esportazione ha un prezzo separato per richiesta (`ppt.export`). Le query di stato, le query di risultato, le query di stato esportazione e l'eliminazione non creano nuovi addebiti.
- Dopo un timeout, interroga il task salvato invece di creare un'altra presentazione. Vedi [Fatturazione ed errori](https://openapi.felo.ai/it/docs/data-api/guides/felo-billing.md).