De vertaling van een cursus aanvullen
patch
https://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:writeAlleen de verzonden velden veranderen; modules en lessen worden toegevoegd aan de reeds vertaalde. Handig om een lang programma in meerdere keren te versturen.
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).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.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 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"
}
}
}'