Questa guida usa cURL e l'endpoint da PDF a Markdown. Lo stesso modello di invio e interrogazione vale per la conversione in EPUB.
1. Crea una chiave API
Crea una chiave API nella OOMOL Console. Conservala sul server o in un gestore di segreti; non inserirla mai in un bundle del browser o in un'applicazione client pubblica.
2. Invia un'attività di conversione
Sostituisci la chiave e l'URL PDF di esempio, quindi invia una richiesta all'endpoint di invio.
curl --request POST "https://fusion-api.oomol.com/v1/pdf-transform-markdown/submit" \--header "Authorization: Bearer YOUR_API_KEY" \--header "Content-Type: application/json" \--data '{"pdfURL": "https://example.com/guide.pdf","model": "gundam"}'
La risposta contiene sessionID, ovvero l'ID attività. Salva questo valore insieme al tuo record di lavoro e usalo al posto di TASK_ID qui sotto, così tentativi e download rimarranno tracciabili.
3. Interroga il risultato
Richiedi l'endpoint del risultato finché lo stato non è completed o failed, oppure finché non viene raggiunto il numero massimo di tentativi o la scadenza. Tratta ogni risposta non 2xx come un errore e interrompi l'interrogazione se state è sconosciuto. Inizia con un breve ritardo e aumenta l'intervallo tra i tentativi per documenti più lunghi.
curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \--header "Authorization: Bearer YOUR_API_KEY"
Leggi lo stato dell'attività da state. Quando è completed, scarica il file generato da data.downloadURL; quando è failed, registra e gestisci il motivo di errore restituito.
Passaggi successivi
- Consulta i concetti API per autenticazione, stati delle attività e tentativi.
- Usa il Riferimento API quando ti servono dettagli sui campi di richiesta e risposta.