Documentation de l’API de traduction

Authentification, première requête sans modification et cycle de commande, avec exemples en PHP natif. L’API v1 prend en charge texte, documents et audio selon les droits du compte.

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

Accès et authentification

Contactez-nous pour définir le compte et ses droits. Les comptes natifs utilisent un jeton Bearer fourni. Cette version ne propose pas de tableau de bord pour créer soi-même des clés d’entreprise. Nous contacter

Authorization: Bearer YOUR_API_TOKEN

Conservez le jeton dans une variable d’environnement ou une configuration serveur protégée. Utilisez HTTPS. Ne placez jamais les identifiants dans les URL, le JavaScript du navigateur ou un dépôt public.

Un hash de mot de passe enregistré n’est pas un mot de passe API. Le SSO du site et l’authentification API sont distincts.

Première requête

Commencez par consulter votre profil. Cette requête ne crée pas de commande et ne débite pas votre solde.

cURL
curl --request GET \
  'https://api.translate24.pro/v1/user/view' \
  --header "Authorization: Bearer $TRANSLATE24_API_TOKEN" \
  --header 'Accept: application/json'

Définissez TRANSLATE24_API_TOKEN sur votre serveur. Vérifiez le statut HTTP et le JSON : une réponse de profil réussie contient un objet user.

Consultez les catalogues actuels et utilisez les identifiants reçus. Les identifiants d’exemple peuvent ne pas être disponibles pour votre compte.

  • GET /languages/get-pairs
  • GET /languages/get-themes
  • GET /languages/get-types
  • GET /order/get-data-for-create-order

PHP natif

Cet exemple en lecture seule utilise l’extension cURL de PHP, sans 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'];

Gardez le profil côté serveur et n’affichez que les champs nécessaires. L’exemple n’imprime ni données client ni identifiants.

Cycle de commande

  1. Choisissez langues, type et thème dans les catalogues. POST /order/create-as-draft crée un enregistrement sans lancer automatiquement un travail payant.
  2. Vérifiez errors, order, price et infoMessage dans la réponse. Certains documents nécessitent un comptage manuel des mots.
  3. POST /order/in-work?id=ORDER_ID&pay_by=1 peut débiter un solde et lancer le travail. Obtenez une approbation explicite avant cet appel.
  4. Suivez l’avancement avec GET /order/view?id=ORDER_ID ou GET /order/index. Limitez la fréquence des consultations.

Champs de création du brouillon

Champs de création du brouillonSignification
type1 : texte · 2 : fichiers · 3 : audio
source_type1 : résultat texte · 2 : résultat audio
language_pair_idIdentifiant du catalogue, ou from_language_code et to_language_code.
translate_type_idIdentifiant du type de traduction dans le catalogue
translate_theme_idIdentifiant du thème dans le catalogue
source_textTexte source d’une commande texte
uploadSourceFiles[]Envoi de fichiers ou d’audio en multipart
user_idFacultatif : client créé par le partenaire authentifié. Sinon, la commande appartient au compte authentifié.

Utilisez des champs de formulaire pour le texte et multipart/form-data pour les fichiers. Laissez le client HTTP générer la délimitation multipart.

Pour in-work, pay_by=1 utilise le solde du compte authentifié ; pay_by=2 celui du propriétaire de la commande, avec les droits de partenaire et le lien client requis.

Fichiers et audio

Documents : txt, odt, pdf, docx ; jusqu’à 5 fichiers de 5 Mio chacun. Audio : mp3, ogg, webm ; jusqu’à 5 fichiers de 15 Mio chacun.

Vérifiez chaque réponse d’envoi. Un identifiant de commande ne suffit pas à autoriser un travail payant si l’analyse ou le comptage des mots échoue.

Erreurs et nouvelles tentatives

401 : vérifiez l’authentification. 403 : vérifiez les droits. 404 : vérifiez l’identifiant et le propriétaire. Une réponse 2xx avec errors est un échec applicatif ; certaines validations renvoient HTTP 200.

Après un délai dépassé ou une erreur 5xx, une écriture peut déjà avoir réussi. Vérifiez l’état avant de réessayer. Ne répétez pas automatiquement création, paiement ou suppression : aucun contrat de clé d’idempotence n’est publié. Les lectures peuvent être réessayées un nombre limité de fois avec attente.

Comptes externes

Les comptes externes utilisent leur mécanisme Basic prévu et peuvent seulement lire leur profil, historique de traductions et catalogues autorisés. Ils ne peuvent ni créer, ni soumettre, ni supprimer des commandes. Convenez d’un compte natif d’intégration ou de partenaire pour l’écriture.

Référence des points d’accès

Les chemins sont relatifs à l’URL de base. L’accès dépend des droits du compte. Consultez Swagger pour les schémas de paramètres ou contactez-nous pour l’accès.

MéthodeCheminFonction
GET/user/viewVotre profil
GET/user/listClients du partenaire
POST/user/registrationCréer un client partenaire
POST/user/deleteSupprimer un client partenaire
GET/order/indexCommandes accessibles
GET/order/viewDétails de la commande
GET/order/get-data-for-create-orderOptions de commande
POST/order/create-as-draftCréer un brouillon
POST/order/in-workApprouver le paiement et lancer le travail
POST/order/deleteSupprimer une commande admissible
GET/languages/get-pairsPaires de langues
GET/languages/get-themesThèmes
GET/languages/get-typesTypes de traduction

Swagger ↗ · Nous contacter