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.
https://api.translate24.pro/v1Accè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_TOKENConservez 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 --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-pairsGET /languages/get-themesGET /languages/get-typesGET /order/get-data-for-create-order
PHP natif
Cet exemple en lecture seule utilise l’extension cURL de PHP, sans 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'];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
- Choisissez langues, type et thème dans les catalogues. POST /order/create-as-draft crée un enregistrement sans lancer automatiquement un travail payant.
- Vérifiez errors, order, price et infoMessage dans la réponse. Certains documents nécessitent un comptage manuel des mots.
- 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.
- 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 brouillon | Signification |
|---|---|
type | 1 : texte · 2 : fichiers · 3 : audio |
source_type | 1 : résultat texte · 2 : résultat audio |
language_pair_id | Identifiant du catalogue, ou from_language_code et to_language_code. |
translate_type_id | Identifiant du type de traduction dans le catalogue |
translate_theme_id | Identifiant du thème dans le catalogue |
source_text | Texte source d’une commande texte |
uploadSourceFiles[] | Envoi de fichiers ou d’audio en multipart |
user_id | Facultatif : 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éthode | Chemin | Fonction |
|---|---|---|
| GET | /user/view | Votre profil |
| GET | /user/list | Clients du partenaire |
| POST | /user/registration | Créer un client partenaire |
| POST | /user/delete | Supprimer un client partenaire |
| GET | /order/index | Commandes accessibles |
| GET | /order/view | Détails de la commande |
| GET | /order/get-data-for-create-order | Options de commande |
| POST | /order/create-as-draft | Créer un brouillon |
| POST | /order/in-work | Approuver le paiement et lancer le travail |
| POST | /order/delete | Supprimer une commande admissible |
| GET | /languages/get-pairs | Paires de langues |
| GET | /languages/get-themes | Thèmes |
| GET | /languages/get-types | Types de traduction |