Panoramica dell'API
Base URL
https://omnidoc.top/api/v1Invia Content-Type: application/json con richieste JSON. La chiave API va inserita nell’intestazione X-API-Key oppure come credenziale Bearer.
Servizi
Sezione intitolata “Servizi”| Servizio | Percorsi principali | Scopo |
|---|---|---|
| Caricamento file | /upload/* | Carica e conferma i documenti |
| Libreria file | /storage/files/*, /documents/* | Elencare, leggere e scaricare |
| Traduzione | /jobs/*, /artifacts/* | Crea lavori, verifica lo stato e i risultati |
| Strumenti per documenti | /document-operations/*, /file-tools/* | Converti, unisci, dividi, comprimi e altro ancora |
| Traduzione istantanea | /ai/* | Traduzione di brevi testi e segmenti batch |
| Audio e video | /media-jobs/*, /media-voices/* | Lavori e voci |
| Glossari | /glossaries/* | Termini, importazione ed esportazione |
| Utilizzo e crediti | /usage/*, /billing/credits/* | Registri di utilizzo, saldo e regolamento |
| Notifiche | /sse/*, /webhooks/* | Progresso in tempo reale e callback |
Quali servizi puoi chiamare e quanto costano: servizi e autorizzazioni .
Convenzioni
Sezione intitolata “Convenzioni”- Gli ID delle risorse sono stringhe opache.
- Invia un
Idempotency-Keycon richieste di creazione; le operazioni di documentazione, i lavori multimediali e la creazione vocale ne richiedono uno. - I parametri di paginazione sono descritti nella pagina di ciascun endpoint.
- Handle
429come descritto in errors and retries . - I nomi dei file scaricati sono solo a scopo di visualizzazione; estrai il nome base e rispetta i limiti del tuo file system prima di salvare.
Tracciamento delle richieste
Sezione intitolata “Tracciamento delle richieste”Mantieni il X-Request-Id di ogni risposta. Quando contatti l’assistenza, fornisci quel valore, l’ora della richiesta e il percorso; non inviare mai la chiave API completa o i contenuti dei file.