De vertaling van een cursus in één taal opslaan
put
https://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:writeMaakt de vertaling voor deze taal aan of VERVANGT ze. Modules en lessen worden aangeduid met hun ID (zie de cursus); een onbekende ID wordt genegeerd. Een gepubliceerde taal die de controles niet meer doorstaat, wordt opnieuw een concept. publish: true publiceert ze in dezelfde aanroep.
Header Authorization: Bearer mudey_sk_… verplicht. Een sleutel aanmaken en gebruiken
Parameters
| Naam | Plaats | Type | Beschrijving |
|---|---|---|---|
| courseId* | pad | string | |
| language* | pad | fr | en | nl | Taal van de site (fr, en of nl), anders dan de taal van de cursus. |
JSON-body
Velden gemarkeerd met * zijn verplicht.
| Veld | Type | Beschrijving |
|---|---|---|
| title | string | Vertaalde titel (verplicht). |
| subtitle | string | null | Vertaalde ondertitel. |
| shortDescription | string | null | Vertaalde slogan. |
| description | string | null | Vertaalde beschrijving, in eenvoudige HTML (alinea's, lijsten, vet, links), opgeschoond bij het opslaan. |
| objectives | string[] | Wat de cursist zal leren, vertaald. |
| requirements | string[] | Vertaalde voorkennis. |
| targetAudience | string[] | Doelgroep, vertaald. |
| welcomeMessage | string | null | Vertaald welkomstbericht, platte tekst: verstuurd met de inschrijvingsbevestiging en getoond in de speler. |
| congratulationsMessage | string | null | Vertaald felicitatiebericht, platte tekst: getoond aan de cursist die de opleiding heeft afgerond. |
| sections | object | Vertaalde modules, per module-ID: { "<sectionId>": { "title": "…" } }. |
| lessons | object | Vertaalde lessen, per les-ID: { "<lessonId>": { "title": "…", "description": "…" } }. |
| publish | boolean | De taal publiceren na het opslaan (volledige vertaling vereist). |
Antwoorden
200Vertaling opgeslagen.400Taal niet beschikbaar (invalid_language): de taal van de cursus zelf, of geen taal van de site.401Sleutel ontbreekt, is ongeldig, ingetrokken of verlopen.403Ontbrekend recht op de sleutel, of het account is geen docent meer.404Bron niet gevonden in uw cursussen.409Publicatie gevraagd maar de vertaling is onvolledig (translation_incomplete): `details` somt op wat ontbreekt.422Ongeldige gegevens (details somt de velden op).429Limiet overschreden (300 aanroepen per minuut per sleutel). Zie de header Retry-After.
Voorbeeld
export MUDEY_API_KEY="mudey_sk_..."
export COURSE_ID="..." # te vervangen
export LANGUAGE="..." # te vervangen
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
}'