Documentazione dell’API di traduzione
Autenticazione, prima richiesta sicura e ciclo dell’ordine, con esempi in PHP nativo. L’API v1 supporta testo, documenti e audio secondo i permessi dell’account.
https://api.translate24.pro/v1Accesso e autenticazione
Contattaci per concordare account e permessi. Gli account nativi usano un token Bearer fornito. Questa versione non offre un pannello per creare autonomamente chiavi aziendali. Contattaci
Authorization: Bearer YOUR_API_TOKENConserva il token in una variabile d’ambiente o configurazione server protetta. Usa HTTPS. Non inserire credenziali in URL, JavaScript del browser o repository pubblici.
Un hash di password salvato non è una password API. SSO del sito e autenticazione API sono meccanismi distinti.
Prima richiesta
Inizia leggendo il profilo. Questa richiesta non crea ordini e non addebita il saldo.
curl --request GET \
'https://api.translate24.pro/v1/user/view' \
--header "Authorization: Bearer $TRANSLATE24_API_TOKEN" \
--header 'Accept: application/json'Imposta TRANSLATE24_API_TOKEN sul server. Verifica stato HTTP e JSON: una risposta corretta del profilo contiene un oggetto user.
Leggi i cataloghi aggiornati e usa gli identificatori restituiti. Gli ID di esempio potrebbero non essere disponibili per il tuo account.
GET /languages/get-pairsGET /languages/get-themesGET /languages/get-typesGET /order/get-data-for-create-order
PHP nativo
Questo esempio di sola lettura usa l’estensione cURL di PHP e non richiede framework.
<?php
$token = getenv('TRANSLATE24_API_TOKEN');
if (!is_string($token) || $token === '') {
throw new RuntimeException('API token is not configured.');
}
$ch = curl_init('https://api.translate24.pro/v1/user/view');
if ($ch === false) {
throw new RuntimeException('Unable to initialize cURL.');
}
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Accept: application/json',
],
]);
$body = curl_exec($ch);
$httpStatus = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($body === false) {
// Keep diagnostic details in a protected server log.
throw new RuntimeException('API connection failed.');
}
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($httpStatus < 200 || $httpStatus >= 300) {
throw new RuntimeException('API HTTP error: ' . $httpStatus);
}
if (!is_array($data) || isset($data['errors'])
|| !isset($data['user']) || !is_array($data['user'])) {
throw new RuntimeException('Unexpected API response.');
}
$user = $data['user'];Conserva il profilo sul server e mostra solo i campi necessari. L’esempio non stampa dati del cliente o credenziali.
Ciclo dell’ordine
- Scegli coppia linguistica, tipo e tema dai cataloghi. POST /order/create-as-draft crea un record senza avviare automaticamente un lavoro a pagamento.
- Verifica errors, order, price e infoMessage nella risposta. Alcuni documenti richiedono il conteggio manuale delle parole.
- POST /order/in-work?id=ORDER_ID&pay_by=1 può addebitare il saldo e avviare il lavoro. Ottieni un’approvazione esplicita prima della chiamata.
- Segui l’avanzamento con GET /order/view?id=ORDER_ID o GET /order/index. Limita la frequenza delle richieste.
Campi della richiesta di bozza
| Campi della richiesta di bozza | Significato |
|---|---|
type | 1: testo · 2: file · 3: audio |
source_type | 1: risultato testuale · 2: risultato audio |
language_pair_id | ID dal catalogo oppure from_language_code e to_language_code. |
translate_type_id | ID del tipo di traduzione dal catalogo |
translate_theme_id | ID del tema dal catalogo |
source_text | Testo originale di un ordine testuale |
uploadSourceFiles[] | Caricamento multipart di file o audio |
user_id | Facoltativo: cliente creato dal partner autenticato. Altrimenti l’ordine appartiene all’account autenticato. |
Usa campi di modulo per il testo e multipart/form-data per i file. Lascia che il client HTTP generi il delimitatore multipart.
Per in-work, pay_by=1 usa il saldo dell’account autenticato; pay_by=2 quello del proprietario dell’ordine e richiede permessi del partner e relazione con il cliente appropriati.
File e audio
Documenti: txt, odt, pdf, docx; massimo 5 file da 5 MiB ciascuno. Audio: mp3, ogg, webm; massimo 5 file da 15 MiB ciascuno.
Controlla ogni risposta al caricamento. Un ID d’ordine non basta per autorizzare lavoro a pagamento se l’analisi o il conteggio parole fallisce.
Errori e nuovi tentativi
401: verifica l’autenticazione. 403: verifica i permessi. 404: verifica ID e proprietà. Una risposta 2xx con errors è un errore applicativo; alcune validazioni restituiscono HTTP 200.
Dopo un timeout o 5xx, una scrittura potrebbe essere già riuscita. Verifica lo stato prima di riprovare. Non ripetere automaticamente creazione, pagamento o eliminazione: non è pubblicato un contratto per chiavi di idempotenza. Le letture possono essere ritentate in modo limitato e con attesa.
Account esterni
Gli account esterni usano il percorso Basic previsto e possono leggere solo profilo, storico traduzioni e cataloghi consentiti. Non possono creare, avviare o eliminare ordini. Concorda un account nativo di integrazione o partner per la scrittura.
Riferimento degli endpoint
I percorsi sono relativi all’URL di base. L’accesso dipende dai permessi. Consulta Swagger per gli schemi dei parametri oppure contattaci per l’accesso.
| Metodo | Percorso | Funzione |
|---|---|---|
| GET | /user/view | Il tuo profilo |
| GET | /user/list | Clienti del partner |
| POST | /user/registration | Creare un cliente partner |
| POST | /user/delete | Eliminare un cliente partner |
| GET | /order/index | Ordini accessibili |
| GET | /order/view | Dettagli dell’ordine |
| GET | /order/get-data-for-create-order | Opzioni dell’ordine |
| POST | /order/create-as-draft | Creare una bozza |
| POST | /order/in-work | Approvare pagamento e avviare lavoro |
| POST | /order/delete | Eliminare un ordine consentito |
| GET | /languages/get-pairs | Coppie linguistiche |
| GET | /languages/get-themes | Temi |
| GET | /languages/get-types | Tipi di traduzione |