Traduire

Nous donnons accès à l'API pour intégrer les systèmes de traduction dans vos projets. Le système se met à jour automatiquement lors de chaque exploitation de celui-ci. Le coût de l'utilisation de l'API Multillect est calculé sur la base de nombre de caractères dans la requête. Coût: $5 par 1000000 caractères.

On fait la traduction en envoyant la requête HTTP sur https://api.multillect.com/translate/json/1.0/<account-id>, où <account-id> — identificateur unique du compte du client.

Méthodes acceptables : GET, POST.
Type de réponse: JSON
Codage  de le réponse: UTF-8

Paramètres de la requête:

Paramètre Obligatoire Description
method oui Doit être translate/api/translate
from non Langue source. S'il manque un paramètre, Multillect tente de déterminer automatiquement la langue source. Le résultat de la détermination de la langue revient dans le champ "language" dans la requête.
to oui Langue cible
text oui Traduction d'un texte codé UTF-8 (texte doit comporter au moins  8 caractères )
politeness non Changement de la forme de conversation polie/impolie. Par example, tu/vous dans la langue russe.
   
Valeur
Description
polite polie
rude impolie
gender_from non Sexe de celui qui parle
   
Valeur Description
male masculin
female féminin
gender_to non Sexe de personne à qui on parle (regarder gender_from).
sig oui Clé secrète

Liste  de toutes  les langues supportées:

Langue Code
Allemand de
Arabe ar
Anglais en
Chinois zh
Coréen ko
Espagnol es
Français fr
Hindi hi
Japonais ja
Kazakh kk
Persan fa
Polonais pl
Portugais pt
Russe ru
Turc tr
Ukrainien uk

Réponse

Réponse est JSON-object avec les propriétés suivantes:

Caractéristiques Description
result Contient un objet avec le résultat de fonctionnement ou "null" en cas de faute
 
Caractéristiques
Description
translated Résultat de la traduction
language Résultat de la détermination de la langue
politeness Forme de conversation automatiquement définie (polie ou impolie). Voir paramètre politeness de requête.
error Contient un objet qui décrit l'erreur ou "null" en cas de réussite
 
Caractéristiques Description
code Code d'erreur
message Texte d'erreur

Exemple 1 (перевод en->ru)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ru&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "тест",
        "language": {
            "code": null
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

Exemple 2 (définition de la langue)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&to=ru&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "тест",
        "language": {
            "code": "en"
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

Exemple 3 (en cas d'erreur )

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ru&text=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": null,
    "error": {
        "code": 15,
        "message": "Too short text for translation"
    },
    "timestamp": 1478022138,
    "id": null
}

Exemple 4 ( définition de la forme de conversation)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=ru&to=en&text=Вы%20великолепны&politeness=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
  "result": {
    "translated": "You are magnificent",
    "language": {
      "code": "ru"
    },
    "politeness": "polite"
  },
  "error": null,
  "timestamp": 1478284482,
  "id": null
}