Ottieni report dettagliati sull'utilizzo delle API con il parametro "Mostra caratteri fatturati" di DeepL
Indice dei contenuti
I punti essenziali
- Gli utenti dell'API di DeepL possono generare report sul numero di caratteri fatturati per ogni richiesta API andata a buon fine.
- Il parametro show_billed_characters offre agli utenti l'accesso immediato ai dati di utilizzo dell'API direttamente nella risposta dell'API.
- Questi dati di utilizzo per ogni richiesta possono essere utilizzati in report personalizzati e flussi di lavoro di monitoraggio dei costi direttamente dall'API.
- Ciò è particolarmente utile per contenuti strutturati come HTML o XML, dove i caratteri traducibili possono essere più difficili da identificare.
- Questa funzione estende la reportistica dell'API di DeepL oltre l'endpoint /usage e ti aiuta a monitorare l'attività di traduzione con maggiore precisione.
- Il nuovo parametro show_billed_characters è già disponibile per tutti i clienti dell'API di DeepL senza alcuna configurazione aggiuntiva.
L'API di DeepL ha sempre considerato la reportistica e l'analisi una priorità per sviluppatori e aziende come la tua. Questo vale sia che si tratti dell'endpoint /usage direttamente nell'API stessa, sia che si tratti della funzionalità di reportistica per più chiavi API.
Il nostro team ha rilasciato questa comoda aggiunta alla nostra lista in continua crescita di strumenti di reportistica: show_billed_characters è ora disponibile per tutti i clienti API.
Questo va ad arricchire le funzionalità di reportistica in continua espansione dell'API di DeepL. Ora consente una visione dettagliata del numero di caratteri fatturati nei dati di risposta per ogni richiesta API.
Scopri come l'API di DeepL ti aiuta a fare ancora di più con la nostra potente IA linguistica.
Cos'è il parametro show_billed_characters?
In precedenza, gli utenti API che desideravano ottenere dati di utilizzo accurati direttamente dall'API di DeepL avevano una sola opzione per richiamare l'endpoint /usage. Questo è un modo efficace per recuperare l'utilizzo dei caratteri più aggiornato per il periodo di fatturazione in corso. Tuttavia, non fornisce una ripartizione accurata dei caratteri tradotti in ogni richiesta.
Un parametro opzionale risolve questo problema restituendo il numero di caratteri tradotti e fatturati con la risposta di ogni richiesta API andata a buon fine.
Scopri la reportistica flessibile a livello di chiave per gli utenti dell'API di DeepL.
Come funziona il parametro show_billed_characters?
I clienti API che effettuano richieste direttamente all'API, ad esempio tramite un comando cURL, possono aggiungere il nuovo parametro show_billed_characters alle loro richieste. Questo restituisce il numero di caratteri fatturati come parte dei dati di risposta.
Le risposte API che comportano un costo per carattere restituiranno quindi un nuovo valore intero nel formato "billed_characters:50" con ogni risposta.
Puoi monitorare questo valore dal lato dell'utente dell'API per utilizzarlo nei flussi di lavoro di reporting e per tenere traccia del costo di ogni singola richiesta API.
Questo è particolarmente importante per le richieste contenenti contenuti strutturati come HTML o XML, dove può essere difficile identificare i caratteri traducibili.
In futuro, il team di DeepL intende includere "billed_characters" nella risposta dell'API di DeepL per impostazione predefinita. A quel punto, sarà necessario impostare show_billed_characters su “false” per non includere “billed_characters” nella risposta API.
Scopri come DeepL rafforza la sicurezza con più chiavi API.
Come appare la risposta API con show_billed_characters
Attualmente, quando invii una richiesta all'API, ottieni una risposta simile a questa:
La tua risposta sarà simile a questa se invii una richiesta utilizzando il nuovo parametro show_billed_characters:
Perché DeepL ha aggiunto il report dei caratteri fatturati per ogni richiesta
Molti clienti hanno richiesto questo strumento. Ti permette di generare report dettagliati sui caratteri fatturati e di integrare questi dati direttamente nei tuoi strumenti di reportistica ad ogni richiesta di traduzione API andata a buon fine.
Il parametro show_billed_characters è pienamente operativo all'interno dell'API di DeepL per gli utenti, senza bisogno di configurazioni aggiuntive.
Inoltre, abbiamo aggiornato la nostra documentazione API per riflettere questa modifica, rendendo più facile per gli sviluppatori come te integrarla nei tuoi flussi di lavoro e iniziare a beneficiare di una maggiore precisione nella traduzione.
Per ulteriori informazioni, leggi Descrizioni del corpo della richiesta e Note di rilascio.