Documentation
Bienvenue sur la Documentation de nos APIs
Bienvenue sur la documentation de nos APIs. Cette documentation regroupe toutes les informations nécessaires pour intégrer facilement nos services dans vos applications.
Consultez chaque API individuellement pour obtenir des instructions détaillées sur son utilisation, ses endpoints disponibles, ainsi que la gestion des erreurs.
Nous vous encourageons à explorer nos APIs et à profiter pleinement de leurs fonctionnalités pour enrichir vos projets.
Documentation de l'API de Détection de Langue
Utilisation
Endpoint de détection de langue
URL : https://www.esacode.org/api/detect
Méthode : POST
Headers : Content-Type: application/json
Corps de la requête :
{
"message": "Hello everyone and welcome to the ESACODE website. "
}
Réponse réussie :
{
"status": "success",
"language": "en",
"language_name": "English"
}
Documentation de l'API de Traduction de Texte
Utilisation
Endpoint de traduction de texte
URL : https://www.esacode.org/api/translate
Méthode : POST
Headers : Content-Type: application/json
Corps de la requête :
{
"message": "Before translating, please select a language.",
"target_language": "fr",
"source_language": "auto", # Ce paramètre n'est pas obligatoire, mais vous pouvez l'ajouter et indiquer "auto" ou le code de la langue de votre texte si vous le souhaitez.
}
Réponse réussie :
{
"status": "success",
"source_language": "en",
"source_language_name": "English",
"target_language": "fr",
"original_text": "Before translating, please select a language.",
"translated_text": "Avant de traduire, veuillez sélectionner une langue."
}
Codes des Langues Supportées
Liste des langues supportées avec leurs codes respectifs pour le paramètre "target_language".
🌟🌟 Langues Africaines
🌟🌟
Langues E - I
Langues O - T
Langues Ts - Z
Langues Internationales
Langues Internationales
A - D
E - H
I - L
M - P
Q - T
U - Z
Note sur les langues africaines :
- Fon : Langue principale du Bénin
- Wolof : Langue nationale du Sénégal
- Afar : Langue de l'Éthiopie
- Baoulé : Langue principale de la Côte d'Ivoire
- Bemba : Langue majeure de la Zambie
- Haoussa : Langue majeure du Nigeria et du Niger
- Igbo : Langue majeure du Nigeria (région du Sud-Est)
- Luo : Langue importante de la Tanzanie
- N'Ko : Système d'écriture et langue du Mali
- Somali : Langue officielle de la Somalie
- Soussou : Langue de la Sierra Leone
- Swati : Langue nationale d'Eswatini
- Kirundi : Langue officielle du Burundi
- Tiv : Langue du Nigeria
- Tumbuka : Langue du Malawi
- Ga : Langue du Ghana
- Acholi : Langue parlée en Ouganda et Soudan du Sud
- Alur : Langue parlée en Ouganda et République Démocratique du Congo
- Amharique : Langue officielle de l'Éthiopie
- Bambara : Langue principale du Mali
- Chichewa : Langue parlée au Malawi, Zambie, Mozambique
- Dioula : Langue véhiculaire en Côte d'Ivoire, Burkina Faso, Mali
- Ewe : Langue parlée au Togo et Ghana
- Kanuri : Langue parlée au Nigeria, Niger, Tchad, Cameroun
- Kikongo : Langue parlée en République Démocratique du Congo, Congo-Brazzaville, Angola
- Kinyarwanda : Langue officielle du Rwanda
- Kituba : Langue véhiculaire en République Démocratique du Congo, Congo-Brazzaville
- Krio : Langue véhiculaire de la Sierra Leone
- Lingala : Langue véhiculaire en République Démocratique du Congo, Congo-Brazzaville
- Luganda : Langue parlée en Ouganda
- Nuer : Langue parlée au Soudan du Sud, Éthiopie
- Oromo : Langue parlée en Éthiopie et Kenya
- Peul : Langue parlée en Afrique de l'Ouest et du Centre
- Sango : Langue véhiculaire en République Centrafricaine
- Sesotho : Langue officielle du Lesotho et parlée en Afrique du Sud
- Shona : Langue principale du Zimbabwe
- Swahili : Langue véhiculaire majeure en Afrique de l'Est (Kenya, Tanzanie, Ouganda, etc.)
- Tamazight : Langue berbère, Afrique du Nord, alphabet latin
- Tamazight (Tifinagh) : Langue berbère, Afrique du Nord, Tifinagh
- Tigrigna : Langue parlée en Érythrée, Éthiopie
- Tsonga : Langue parlée au Mozambique, Afrique du Sud
- Tswana : Langue parlée au Botswana, Afrique du Sud
- Venda : Langue parlée en Afrique du Sud, Zimbabwe
- Xhosa : Langue parlée en Afrique du Sud
- Zoulou : Langue parlée en Afrique du Sud
Et ce n'est qu'une petite partie ! La liste continue de s'agrandir. Consultez notre documentation pour découvrir toutes les langues disponibles ! 🌍
Exemple de requête API :
{
"message": "Texte à traduire",
"target_language": "en"
}
Gestion des Erreurs de l'API
Lorsque l'API rencontre une erreur, elle renvoie une réponse JSON incluant un champ success défini à false et un champ erreur fournissant des détails sur l'erreur.
Exemple de réponse en cas d'erreur :
{
"success": error,
"erreur": "Description de l'erreur"
}
Les erreurs peuvent survenir pour plusieurs raisons, telles que :
- Requête malformée (par exemple, corps de la requête manquant ou incorrect)
- Problème de connexion au service de traduction
- Texte vide fourni à l'API
- Codes de langue non pris en charge ou incorrects
Il est recommandé de vérifier la réponse de l'API pour le champ success et de gérer les erreurs en conséquence dans votre application ou script.