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.

URL di basehttps://api.translate24.pro/v1

Accesso 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_TOKEN

Conserva 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
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-pairs
  • GET /languages/get-themes
  • GET /languages/get-types
  • GET /order/get-data-for-create-order

PHP nativo

Questo esempio di sola lettura usa l’estensione cURL di PHP e non richiede framework.

PHP
<?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

  1. Scegli coppia linguistica, tipo e tema dai cataloghi. POST /order/create-as-draft crea un record senza avviare automaticamente un lavoro a pagamento.
  2. Verifica errors, order, price e infoMessage nella risposta. Alcuni documenti richiedono il conteggio manuale delle parole.
  3. 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.
  4. 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 bozzaSignificato
type1: testo · 2: file · 3: audio
source_type1: risultato testuale · 2: risultato audio
language_pair_idID dal catalogo oppure from_language_code e to_language_code.
translate_type_idID del tipo di traduzione dal catalogo
translate_theme_idID del tema dal catalogo
source_textTesto originale di un ordine testuale
uploadSourceFiles[]Caricamento multipart di file o audio
user_idFacoltativo: 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.

MetodoPercorsoFunzione
GET/user/viewIl tuo profilo
GET/user/listClienti del partner
POST/user/registrationCreare un cliente partner
POST/user/deleteEliminare un cliente partner
GET/order/indexOrdini accessibili
GET/order/viewDettagli dell’ordine
GET/order/get-data-for-create-orderOpzioni dell’ordine
POST/order/create-as-draftCreare una bozza
POST/order/in-workApprovare pagamento e avviare lavoro
POST/order/deleteEliminare un ordine consentito
GET/languages/get-pairsCoppie linguistiche
GET/languages/get-themesTemi
GET/languages/get-typesTipi di traduzione

Swagger ↗ · Contattaci