Enregistrer la traduction d'une formation dans une langue
put
https://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:writeCrée ou REMPLACE la traduction de cette langue. Modules et leçons sont désignés par leur identifiant (voir la formation) ; un identifiant inconnu est ignoré. Une langue en ligne qui ne passe plus les contrôles repasse en brouillon. publish: true la met en ligne dans le même appel.
En-tête Authorization: Bearer mudey_sk_… obligatoire. Créer et utiliser une clé
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
| courseId* | chemin | string | |
| language* | chemin | fr | en | nl | Langue du site (fr, en ou nl), autre que la langue de la formation. |
Corps JSON
Les champs marqués * sont obligatoires.
| Champ | Type | Description |
|---|---|---|
| title | string | Titre traduit (obligatoire). |
| subtitle | string | null | Sous-titre traduit. |
| shortDescription | string | null | Accroche traduite. |
| description | string | null | Description traduite, en HTML simple (paragraphes, listes, gras, liens), nettoyée à l'enregistrement. |
| objectives | string[] | Ce que l'élève apprendra, traduit. |
| requirements | string[] | Prérequis traduits. |
| targetAudience | string[] | Public visé, traduit. |
| welcomeMessage | string | null | Message de bienvenue traduit, en texte simple : envoyé avec la confirmation d'inscription et affiché dans le lecteur. |
| congratulationsMessage | string | null | Message de félicitations traduit, en texte simple : affiché à l'élève qui a terminé la formation. |
| sections | object | Modules traduits, par identifiant de module : { "<sectionId>": { "title": "…" } }. |
| lessons | object | Leçons traduites, par identifiant de leçon : { "<lessonId>": { "title": "…", "description": "…" } }. |
| publish | boolean | Mettre la langue en ligne après l'enregistrement (traduction complète exigée). |
Réponses
200Traduction enregistrée.400Langue indisponible (invalid_language) : celle de la formation, ou hors du site.401Clé absente, invalide, révoquée ou expirée.403Droit manquant sur la clé, ou compte qui n'est plus formateur.404Ressource introuvable dans vos formations.409Mise en ligne demandée mais traduction incomplète (translation_incomplete) : `details` liste ce qui manque.422Données invalides (details liste les champs).429Quota dépassé (300 appels par minute et par clé). Voir l'en-tête Retry-After.
Exemple
export MUDEY_API_KEY="mudey_sk_..."
export COURSE_ID="..." # à remplacer
export LANGUAGE="..." # à remplacer
curl -X PUT "https://mudey.fr/api/v1/courses/$COURSE_ID/translations/$LANGUAGE" \
-H "Authorization: Bearer $MUDEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Learn TypeScript",
"subtitle": "From the basics to advanced types",
"description": "<p>From the basics to advanced types, with corrected exercises in every section.</p>",
"objectives": [
"Type a React application",
"Write generic types"
],
"welcomeMessage": "Welcome! Start with the first section, at your own pace.",
"congratulationsMessage": "Well done, you have completed the course!",
"sections": {
"4b2f0c1e-0000-4000-8000-000000000001": {
"title": "The basics"
}
},
"lessons": {
"9d1a7e3c-0000-4000-8000-000000000011": {
"title": "Installing TypeScript"
},
"9d1a7e3c-0000-4000-8000-000000000012": {
"title": "Primitive types"
}
},
"publish": true
}'