Compléter la traduction d'une formation
patch
https://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:writeSeuls les champs envoyés changent ; modules et leçons s'ajoutent à ceux déjà traduits. Pratique pour envoyer un long programme en plusieurs fois.
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).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.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 PATCH "https://mudey.fr/api/v1/courses/$COURSE_ID/translations/$LANGUAGE" \
-H "Authorization: Bearer $MUDEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lessons": {
"9d1a7e3c-0000-4000-8000-000000000013": {
"title": "Union types"
}
}
}'