MudeyMudeyDocumentation de l’API
    OpenAPIMes clésRetour sur Mudey

    Guide

    • Présentation
    • Démarrer
    • Mettre une formation en ligne
    • Erreurs
    • Sécurité
    Compte
    • getCompte et droits de la clé
    • getCatégories du catalogue
    Formations
    • getLister mes formations
    • postCréer une formation
    • getLire une formation complète
    • patchModifier une formation
    • delSupprimer une formation
    • postMettre en ligne
    • postRetirer du catalogue
    Modules
    • postAjouter un module
    • putRéordonner les modules
    • patchModifier un module
    • delSupprimer un module
    Leçons
    • postAjouter une leçon
    • putRéordonner les leçons d'un module
    • getLire une leçon
    • patchModifier une leçon
    • delSupprimer une leçon
    • getLister les questions d'un quiz
    • postAjouter une question à un quiz
    • putRemplacer les questions d'un quiz
    • getLister les transcriptions d'une leçon
    • getLire la transcription d'une leçon dans une langue
    • putDéposer la transcription d'une leçon dans une langue
    • delSupprimer la transcription d'une leçon dans une langue
    Fichiers
    • postObtenir une adresse d'envoi
    Traductions
    • getLister les traductions d'une formation
    • getLire la traduction d'une formation dans une langue
    • putEnregistrer la traduction d'une formation dans une langue
    • patchCompléter la traduction d'une formation
    • delSupprimer la traduction d'une formation dans une langue
    • postMettre en ligne une traduction
    • postRetirer une traduction du site
    Coupons
    • getLister mes coupons
    • postCréer un coupon
    • getLire un coupon
    • patchModifier un coupon
    • delSupprimer un coupon
    Élèves et revenus
    • getÉlèves d'une formation
    • getStatistiques d'une formation
    • getStatistiques de toutes mes formations
    • getRevenus d'un mois

    Sur cette page

    PUT /courses/{courseId}/translations/{language}
    • Paramètres
    • Corps JSON
    • Réponses
    • Exemple

    Traductions3 / 7

    • getLister les traductions d'une formation
    • getLire la traduction d'une formation dans une langue
    • putEnregistrer la traduction d'une formation dans une langue
    • patchCompléter la traduction d'une formation
    • delSupprimer la traduction d'une formation dans une langue
    • postMettre en ligne une traduction
    • postRetirer une traduction du site
    1. API formateurs
    2. Traductions
    3. Enregistrer la traduction d'une formation dans une langue

    Enregistrer la traduction d'une formation dans une langue

    puthttps://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:write

    Cré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

    NomEmplacementTypeDescription
    courseId*cheminstring
    language*cheminfr | en | nlLangue du site (fr, en ou nl), autre que la langue de la formation.

    Corps JSON

    Les champs marqués * sont obligatoires.

    ChampTypeDescription
    titlestringTitre traduit (obligatoire).
    subtitlestring | nullSous-titre traduit.
    shortDescriptionstring | nullAccroche traduite.
    descriptionstring | nullDescription traduite, en HTML simple (paragraphes, listes, gras, liens), nettoyée à l'enregistrement.
    objectivesstring[]Ce que l'élève apprendra, traduit.
    requirementsstring[]Prérequis traduits.
    targetAudiencestring[]Public visé, traduit.
    welcomeMessagestring | nullMessage de bienvenue traduit, en texte simple : envoyé avec la confirmation d'inscription et affiché dans le lecteur.
    congratulationsMessagestring | nullMessage de félicitations traduit, en texte simple : affiché à l'élève qui a terminé la formation.
    sectionsobjectModules traduits, par identifiant de module : { "<sectionId>": { "title": "…" } }.
    lessonsobjectLeçons traduites, par identifiant de leçon : { "<lessonId>": { "title": "…", "description": "…" } }.
    publishbooleanMettre 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
    }'
    PrécédenteLire la traduction d'une formation dans une langueSuivanteCompléter la traduction d'une formation

    © 2026 Mudey · Documentation de l’API

    openapi.jsonCentre d’aideContact