Adobe Learning Manager Developer Manual

Overzicht

Adobe Learning Manager biedt RESTful-API's waarmee ontwikkelaars toepassingen of workflows effectief kunnen integreren en aanpassen. De ontwikkelaarshandleiding biedt richtlijnen voor het gebruik van deze API's, met onderwerpen zoals verificatie, gegevensmodellen en integratie met andere toepassingen. Bovendien, helpt deze gids API verwijzingsdocumentatieontwikkelaars in het creëren van externe toepassingen of achterste werkschema's die met diverse eigenschappen van Adobe Learning Manager, met inbegrip van cursusverwezenlijking, het volgen van studentenvooruitgang, vaardigheidstoewijzing, certificatie, gamification, en transcripten interactie aangaan.

Deze handleiding behandelt het volgende:

API-gebruiksscenario's

Ontwikkelaars kunnen API's van Learning Manager gebruiken om de Learning Manager te verbeteren of te integreren met andere bedrijfstoepassingen. U kunt web-, desktop- of mobiele apps maken met elke technologie. Ontwikkelaars hebben toegang tot Leerbeheergegevens, maar u bepaalt waar en hoe de app wordt gebruikt.

Verificatie met OAuth 2.0

Om Adobe Learning Manager API's veilig te openen, moet u zich verifiëren met het OAuth 2.0-mechanisme van Adobe Learning Manager. Dit proces omvat het registreren van uw toepassing, het genereren van een machtigingscode, het uitwisselen van een vernieuwingstoken en het gebruiken van het vernieuwingstoken om een toegangstoken te krijgen.

Een toepassing registreren

Integreer Adobe Learning Manager met externe toepassingen voor verbeterde veelzijdigheid. De stappen omvatten de toegang tot de interface van de Beheerder van de Integratie, het registreren van de toepassing, en het verkrijgen van cliëntidentiteitskaart en Geheime. Genereer OAuth 2.0-verificatietokens uit Adobe Learning Manager, inclusief verificatie-, vernieuwings- en toegangstokens. Gebruik de OAuth 2.0-stroom om uw app veilig te verifiëren en autoriseren. De toegangstoken is zeven dagen geldig.

Een toegangstoken verkrijgen

Verkrijg de machtigingscode

Nadat u de client-id en het clientgeheim hebt opgehaald, kunt u deze gebruiken om een toegangstoken aan te vragen. Zo kunt u API-aanroepen verifiëren.

Als u wilt beginnen met de stroom van de machtigingscode, voegt u de volgende URL toe in een browser:

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<one or more comma separated scopes>&response_type=CODE

Zodra de gebruiker de toepassing goedkeurt, leidt Adobe Learning Manager de opgegeven redirect_uri om met een toegevoegde queryparameter:

https://yourapp.com/callback?code=abc123xyz

Er wordt een parametercode toegevoegd samen met de omleidingsuri.

Vernieuwingstoken ophalen uit code

Nadat u de code hebt ontvangen, gebruikt u een API-gereedschap en voegt u de volgende POST-aanvraag toe:

https://learningmanager.adobe.com/oauth/token

Lichaam van het Verzoek (x-www-vorm-urlencoded):

grant_type=authorization_code
&code=abc123xyz
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&redirect_uri=<your_redirect_url>

Antwoord

{

  "access_token": "eyJhbGciOiJIUzI1...",
  "refresh_token": "xTjlfz0jCk6gF1...",
  "expires_in": 604800,
  "token_type": "Bearer"

}

Gebruik het access_token in de machtigingheader om geverifieerde API-aanvragen in te dienen.

Het toegangstoken in een API-aanroep gebruiken

Verifieer het toegangstoken met behulp van het volgende:

GET https://learningmanager.adobe.com/oauth/token/check?access_token=<access_token>

Een toegangstoken is zeven dagen geldig. Na zeven dagen moet u een nieuw toegangstoken genereren met een vernieuwingstoken. Als u met een vernieuwingstoken een nieuw toegangstoken genereert terwijl een bestaand toegangstoken nog geldig is, wordt het bestaande token geretourneerd.

Toegangstokens verkrijgen voor testen en ontwikkelen

Als ontwikkelaars met Adobe Learning Manager API's werken, hebben ze een geldig OAuth 2.0-toegangstoken nodig om API-verzoeken te verifiëren. Het genereren van dit token via de standaard OAuth-flow kan complex en tijdrovend zijn, met name voor snel testen, leren of ontwikkelen. Adobe Learning Manager biedt een hulpprogramma voor het genereren van tokens om dit proces te vereenvoudigen.

Dit gereedschap is ideaal tijdens:

Deze tokens zijn uitsluitend bedoeld voor persoonlijk gebruik tijdens ontwikkelings- en foutopsporingsfasen. Houd er rekening mee dat testtokens toegang geven tot je Adobe Learning Manager-data, dus het is essentieel om ze veilig te verwerken. Deel je testtokens nooit met anderen, gebruik ze in productietoepassingen of neem ze op in openbare codeopslagplaatsen. Behandel ze als wachtwoorden om de beveiliging van je account en data te waarborgen.

Op het selecteren legt voor, wordt het toegangstoken geverifieerd, en u zult het volgende voorwerp JSON ontvangen:

{
  "access_token": "access token",
  "refresh_token": "refresh token",
  "user_role": "admin",
  "account_id": "1234",
  "user_id": "123456",
  "expires_in": 604800
}

Net als voorheen verloopt het toegangstoken voor testen over zeven dagen.

Een API-tool gebruiken om de eindpunten te testen

U kunt een API-testtool van derden gebruiken, maar Postman wordt gebruikt om de eindpunten te testen. In de voorbeelden in dit document wordt Postman gebruikt voor het testen van de eindpunten.

Typen API's

Admin-API's

Met de Admin API's van Adobe Learning Manager kunnen beheerders leerbewerkingen op grote schaal automatiseren en beheren.

Met de Admin API's kunnen ontwikkelaars:

De Verwijzing van de mening Adobe Learning Manager APIvoor meer informatie.

Student-API's

De API's voor studenten zijn ontworpen voor geverifieerde gebruikers (studenten) en bieden u toegang tot studentspecifieke informatie. Deze API's staan taken toe zoals:

Belangrijke punten:

De Verwijzing van de mening Adobe Learning Manager APIvoor meer informatie.

API-ontwerp en algemene parameters

De API's bieden ontwikkelaars toegang tot belangrijke leermanschappen zoals gebruikers, cursussen, vaardigheden, certificeringen en leerprogramma's. Hiervoor worden REST-principes gebruikt, waarbij HTTP-methoden (GET, POST, PUT, DELETE) worden gebruikt voor gegevensbewerkingen.

Algemene parameters

Hier volgt een korte uitleg van elk:

include

Adobe Learning Manager API's kunnen worden gebruikt om nuttige informatie op te halen tijdens het bouwen van een aangepaste toepassing of een headless LMS. De API-eindpunten kunnen verder worden opgenomen met aanvullende 'include'-parameters om de extra informatie op te halen die betrekking heeft op de gegevens die standaard worden ontvangen. Deze relaties zijn relaties met gegevensmodellen. Als u bijvoorbeeld een oproep doet om gebruikersgegevens op te halen, ontvangt u de gebruikersgegevens en de relatie van de manager-id en de Adobe Learning Manager-account-id. Met de parameter include kunt u op een gedetailleerde manier aanvullende gegevens ophalen samen met de gebruikersgegevens, zoals de beheergegevens en de Adobe Learning Manager-accountgegevens.
Kortom, omvat parameter wordt gebruikt in API vraag om verwante (verbonden) middelen samen met het primaire middel in één enkele reactie te halen. Het is handig als u toegang wilt tot geneste of afhankelijke gegevens, zoals modules van een cursus of de vaardigheden die aan een student zijn toegewezen, zonder afzonderlijke API-aanroepen te maken.

Belangrijkste voordelen:

hoe te om te gebruiken omvat parameter

Voeg de parameter include toe aan uw API-URL en geef op welke verwante entiteiten u wilt opnemen.

gemeenschappelijk omvat wegen

Voorbeeld 1

Haal de details op van een gebruiker die userID parameter in het eindpunt gebruikt.

https://learningmanager.adobe.com/primeapi/v2/users/<userID>

GET https://learningmanager.adobe.com/primeapi/v2/users/<userID>

In de reactie kunt u zien dat het gegevensobject een relatie heeft met het account en de manager van de gebruiker.

"relationships": {
            "account": {
                "data": {
                    "id": "1010",
                    "type": "account"
                }
            },
            "manager": {
                "data": {
                    "id": "3400476",
                    "type": "user"
                }
            }
        }

Met de parameter include in de aanvraag kunt u gedetailleerde informatie over de manager ophalen, zoals hieronder wordt weergegeven:

GET https://learningmanager.adobe.com/primeapi/v2/users/<userid>?include=manager

Voorbeeld 2

Gebruik de parameter include in de aanroep van het eindpunt om de cursusdetails op te halen. Het volgende eindpunt krijgt de cursusinformatie samen met de relaties.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects/<courseID>

De relaties worden als volgt weergegeven in de reactie:

"relationships": {
            "authors": {
                "data": [
                    {
                        "id": "3400468",
                        "type": "user"
                    }
                ]
            },
            "instances": {
                "data": [
                    {
                        "id": "course:16444_31598",
                        "type": "learningObjectInstance"
                    }
                ]
            },
            "skills": {
                "data": [
                    {
                        "id": "course:16444_1796",
                        "type": "learningObjectSkill"
                    },
                    {
                        "id": "course:16444_3103",
                        "type": "learningObjectSkill"
                    }
                ]
            }
        }

Andere relaties kunnen (niet aanwezig in het bovenstaande antwoord) omvatten:

Als u gedetailleerde gegevens wilt over de instanties en vaardigheden, neemt u 'instanties,vaardigheden' op in de parameter include.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects/<courseID>?include=instances,skills

Als u bijvoorbeeld meer gegevens wilt ophalen die aan de cursusinstantie zijn gekoppeld, zoals loResources (module-informatie van de cursus), moet u loResources toepassen als een genest include-bestand.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects/<courseID>?include=instances.loResources

Combineer vaardigheden en instanties met een genest include-bestand.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects/<courseID>?include=instances,instances.loResources,skills

andere omvatten filters

velden

De kenmerken en relaties van een API-object worden velden genoemd. Gebruik Velden als een parameter in API-aanroepen om specifieke kenmerken van het model op te halen. Zonder de parameter Fields haalt de API-aanroep alle beschikbare kenmerken op.

Bijvoorbeeld, in de volgende API vraag, haalt de gebieden [ vaardigheid ]=name u het naamattribuut van het vaardigheidsmodel alleen.

GET https://learningmanager.adobe.com/primeapi/v2/users/3400490/userSkills/3400490_1796_1?include=skillLevel.skill&fields[skill]=name

paginering

API-paginering is een techniek die in API's wordt gebruikt om grote gegevenssets op te splitsen in kleinere, beheerbare blokken, pagina's genoemd, in plaats van de volledige gegevens in één reactie te retourneren.

Paginering vermindert het laden van de client en de server, beperkt de reactiegrootte om knelpunten in de server te voorkomen of is handig voor het weergeven van gegevens in tabellen of lijsten van één pagina tegelijk.

Hoe de paginering in Adobe Learning Manager APIs werkt

Adobe Learning Manager API's ondersteunen paginering via parameters zoals:

Hieronder wordt beschreven hoe u paginering in API's kunt gebruiken:

pagina [ grens]

Terwijl https://learningmanager.adobe.com/primeapi/v2/usersalle gebruikers en verwante informatie in één enkele vraag terugkeert, beperkt het gebruiken van pagina [ grens ] het aantal resultaten tot de gespecificeerde waarde.

Gebruik de volgende API om slechts vijf gebruikersrecords in één aanroep te retourneren:

GET https://learningmanager.adobe.com/primeapi/v2/users?page[limit]=5

pagina [ verschuiving]

Gebruik deze API-aanroep om drie gebruikersrecords te retourneren, de eerste vijf gebruikers over te slaan en vanaf de zesde te beginnen.

GET https://learningmanager.adobe.com/primeapi/v2/users?page[limit]=3&page[offset]=5

pagina [ curseur]

Hiermee wordt de volgende set van 10 records geretourneerd, te beginnen na het laatste item van de vorige pagina.

filter

Met de filterparameter kunt u de API-resultaten beperken op basis van een of meer veldwaarden.

Adobe Learning Manager API's bieden verschillende variaties van de filterparameter om de reacties te beperken.

De Verwijzing van de mening Adobe Learning Manager APIvoor meer informatie.

In dit voorbeeld wordt getoond hoe u de taakhulpen kunt filteren waarvoor een student zich heeft ingeschreven bij het gebruiken van het eindpunt met de filterparameter:

GET https://learningmanager.adobe.com/primeapi/v2/users/3400480/enrollments?filter.loTypes=jobAid

sorteren

De sorteerparameter wordt gebruikt voor het sorteren van API-resultaten in oplopende of aflopende volgorde op basis van een of meer velden.

De Adobe Learning Manager biedt verschillende sorteeropties voor het sorteren van de API-reactie. De Verwijzing van de mening Adobe Learning Manager APIvoor meer informatie.

Als u het vorige voorbeeld uitbreidt, sorteert u nu de inschrijving van de gebruiker naar leerprogramma's op datum die in oplopende volgorde is ingeschreven.

GET https://learningmanager.adobe.com/primeapi/v2/users/3400480/enrollments?filter.lotypes=learningProgram&sort=dateEnrolled

Overzicht van API-modellen

Met de Adobe Learning Manager API's hebben ontwikkelaars toegang tot leermantobjecten als RESTful-bronnen. Elk API-eindpunt vertegenwoordigt een bron, meestal een object zoals een badge, of een verzameling van dergelijke objecten. De ontwikkelaars gebruiken dan de werkwoorden van HTTP zoals PUT, GET, POST en DELETE om de verrichtingen CRUD op die voorwerpen (inzamelingen) uit te voeren.

Student-API's en eindpunten

Hier volgen belangrijke API-eindpunten voor het werken met studentgegevens. Deze API's begeleiden ontwikkelaars bij het werken met studentgegevens, het volgen van de voortgang, het beheren van inschrijvingen en het ophalen van cursusinhoud.

Details van alle studenten ophalen

Haal de gegevens van de student op (naam, e-mail, UUID, gebruikersprofiel, enzovoort). Gebruik de API om alle studenten in het account weer te geven.

GET https://learningmanager.adobe.com/primeapi/v2/users

Gegevens van een specifieke student ophalen

Als u het profiel van een student wilt bekijken op ID, gebruikt u de volgende API om te bellen.

GET https://learningmanager.adobe.com/primeapi/v2/users/<userID>

Alle cursussen, leerprogramma's, taakhulpen en certificeringen weergeven

Haal de gegevens op van alle leerobjecten waarin de student is ingeschreven, is voltooid of door de beheerder is ingeschakeld.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects

Details ophalen van een specifiek leerobject

Krijg gedetailleerde informatie over een leerobject. Deze bevat de aanmaakdatum, de publicatiedatum, de bijgewerkte datum en andere informatie.

GET https://learningmanager.adobe.com/primeapi/v2/learningObjects/<LearningObjectID>

Lijst met vaardigheden ophalen die zijn gekoppeld aan cursussen

Geef de vaardigheden weer die aan alle studenten in het account zijn toegewezen.

GET https://learningmanager.adobe.com/primeapi/v2/skills

Informatie over vaardigheidsniveau en badges ophalen

Controleer de voortgang van de studenten in de op vaardigheden gebaseerde leertrajecten.

GET https://learningmanager.adobe.com/primeapi/v2/skills/<skillID>?include=levels

Lijst met alle badges die voor een account zijn gemaakt

Bel het volgende eindpunt om een lijst op te halen met alle badges die voor een account in een organisatie zijn gemaakt.

GET https://learningmanager.adobe.com/primeapi/v2/badges

Informatie van een badge ophalen

Verkrijg gedetailleerde informatie over een badge, zoals de badgenaam, de afbeeldings-URL van de badge en de status van de badge.

GET https://learningmanager.adobe.com/primeapi/v2/badges/<skillID>

Dit levert de volgende reactie op:

{
    "links": {
        "self": "https://learningmanager.adobe.com/primeapi/v2/badges/499"
    },
    "data": {
        "id": "499",
        "type": "badge",
        "attributes": {
            "imageUrl": "https://cpcontentsdev.adobe.com/public/account/1010/accountassets/1010/badges/test_57a5ab00555a475a8fc6671562184dc9.png",
            "name": "penguins",
            "state": "Retired"
        }
    }
}

Andere voorbeelden van API-gebruik

Een gebruiker maken

Er zijn drie verplichte kenmerken:

U ontvangt het volgende JSON-object:

{
  "links": {
      "self": "https://learningmanager.adobe.com/primeapi/v2/users"
  },
  "data": {
      "id": "13386404",
      "type": "user",
      "attributes": {
          "avatarUrl": "https://cpcontents.adobe.com/public/images/default_user_avatar.svg",
          "email": "bob@example.com",
          "name": "Bob",
          "pointsEarned": 0,
          "pointsRedeemed": 0,
          "preferredResolution": "AUTO",
          "profile": "Employee",
          "roles": [
              "Learner"
          ],
          "state": "ACTIVE",
          "userType": "Internal",
          "userUniqueId": "bob@example.com"
      },
      "relationships": {
          "account": {
              "data": {
                  "id": "1010",
                  "type": "account"
              }
          },
          "manager": {
              "data": {
                  "id": "3400468",
                  "type": "user"
              }
          }
      }
  }
}

Een gebruiker verwijderen

Er verschijnt een reactie van 204. Een 204-responscode geeft aan dat de code is gelukt zonder dat er inhoud is die moet worden geretourneerd. De server heeft het verzoek verwerkt, maar heeft geen gegevens om aan de client te verstrekken.

De status van de gebruiker wordt nu VERWIJDERD nadat u de details van de gebruiker terugwint.

Gebruikersgegevens bijwerken

PATCH https://learningmanager.adobe.com/primeapi/v2/users/<userID>

Voeg het volgende toe in de lading van de aanvraag om de gebruiker bij te werken met de id <userID> uit de vorige sectie.

Wijzig elk veld in de lading.

{
    "data": {
        "id": "3400468",
        "type": "user",
        "attributes": {
            "avatarUrl": "https://cpcontents.adobe.com/public/images/default_user_avatar.svg",
            "binUserId": "3e6d571f-3956-44db-be69-8e458bde649f",
            "bio": "Manager",
            "contentLocale": "de-DE",
            "email": "user@example.com",
            "enrollOnClick": true,
            "fields": {
                "Web": "Web",
                "newfororder": "newvalue",
                "location": "New",
                "test1": "b"
            },
            "gamificationEnabled": true,
            "lastLoginDate": "2025-04-30T09:30:51.000Z",
            "metadata": {
                "level": "5",
                "expertise": "java",
                "sport": "tennis"
            },
            "name": "John Adams",
            "pointsEarned": 8600,
            "pointsRedeemed": 0,
            "preferredResolution": "AUTO",
            "profile": "Employee",
            "roles": [
                "Learner",
                "Admin",
                "Author",
                "Instructor",
                "Integration Admin",
                "Manager"
            ],
            "state": "ACTIVE",
            "timeZoneCode": "213",
            "uiLocale": "en-US",
            "userType": "Internal",
            "userUniqueId": "user@example.com"
        },
        "relationships": {
            "account": {
                "data": {
                    "id": "1010",
                    "type": "account"
                }
            }
        }
    }
}

Nadat u de vraag maakt, worden de details van de gebruiker bijgewerkt.

Een extern profiel maken

Een extern profiel verwijst naar een gebruikersprofiel dat is gemaakt voor externe studenten, doorgaans individuen die geen deel uitmaken van de interne gebruikersbasis van de organisatie. Tot deze studenten kunnen klanten, partners, leveranciers, franchisehouders of tijdelijke contractanten behoren die toegang nodig hebben tot door de organisatie aangeboden trainings- of certificeringsprogramma's.

{
    "data": {
      "type": "externalProfile",
      "attributes": {
        "name": "Jonas Albertson",
        "expiry": "2027-12-31T18:29:59.000Z",
        "managerEmail": "jonas@acme.com",
        "seatLimit": 10
      }
    }
}

De lading heeft de volgende attributen:

Nadat u de vraag maakt, krijgt u de volgende reactie:

{
    "links": {
        "self": "https://learningmanager.adobe.com/primeapi/v2/externalProfiles"
    },
    "data": {
        "id": "18805",
        "type": "externalProfile",
        "attributes": {
            "accessKey": "8gte2ne7f4r14",
            "enabled": true,
            "expiry": "2027-12-31T18:29:59.000Z",
            "managerEmail": "jonas@acme.com",
            "name": "Jonas Albertson",
            "seatLimit": 10,
            "url": "https://learningmanager.adobe.com/eplogin?groupid=18805&accesskey=8gte2ne7f4r14"
        }
    }
}

Dit betekent dat de externe gebruiker is toegevoegd aan Adobe Learning Manager. Verzend de URL in de reactie naar de gebruiker, met behulp waarvan deze zich kan registreren op het platform.

Gebruikersrapport extraheren met gebruikers-ID en managergegevens

Een gebruikersrapport kan direct van het gebruikersinterface van de beheerder worden gedownload (Admin > Gebruikers > Intern). Het rapport retourneert echter niet de gebruikers-id en de gegevens van de bijbehorende manager.

Gebruik de Jobs-API om het rapport te downloaden. De API voor Taken helpt bij het genereren van rapporten, bulkbewerkingen (inschrijvingen of badgetoewijzingen), certificeringsvoltooiing of het genereren van badges.

Hieronder wordt beschreven hoe u het rapport kunt downloaden:

internalUserID, userEmail, customerDefinedUniqueUserId, name, managerEmail, userType, state, excludeFromGamification, pointsEarned, profile, rollen, dateCreated, lastLoginDate, dateDeleting, uiLocale, contentLocale, timeZoneCode, userSource, group, Active fields, metadata en lastSocial ActivityDate.

Badge genereren met de Jobs API

Gebruikers maken in Adobe Learning Manager

Het POST /users eindpunt helpt u een gebruiker creëren gebruikend de headless wijze. Maak gebruikers met gedetailleerde informatie, zoals het registratieproces in de native gebruikersinterface in Adobe Learning Manager.

Bijvoorbeeld:

POST https://learningmanager.adobe.com/primeapi/v2/users

Voeg de volgende tekst toe aan de aanvraag:

{
   "data":
     {
       "type": "user",
       "attributes": {
         "bio": "",
         "contentLocale": "fr-FR",
         "email": "user@work.com",
         "enrollOnClick": true,
         "fields": {
           "Learning Categories": [
             "Business"
           ],
           "Categories": "IT"
         },
         "gamificationEnabled": true,
         "name": "Test User",
         "profile": "Engineer",
         "userType": "INTERNAL",
         "userUniqueId": "user@work.com"
       },
       "relationships": {
         "account": {
           "data": {
             "id": "108079",
             "type": "account"
           }
         }
         }
       }
    }

Nadat u de vraag maakt, verschijnt de volgende reactie:

{
    "links": {
        "self": "https://learningmanager.adobe.com/primeapi/v2/users"
    },
    "data": {
        "id": "13385627",
        "type": "user",
        "attributes": {
            "avatarUrl": "https://cpcontents.adobe.com/public/images/default_user_avatar.svg",
            "email": "user@work.com",
            "name": "Test User",
            "pointsEarned": 0,
            "pointsRedeemed": 0,
            "preferredResolution": "AUTO",
            "profile": "Engineer",
            "roles": [
                "Learner"
            ],
            "state": "ACTIVE",
            "userType": "Internal",
            "userUniqueId": "user@work.com"
        },
        "relationships": {
            "account": {
                "data": {
                    "id": "1010",
                    "type": "account"
                }
            },
            "manager": {
                "data": {
                    "id": "3400468",
                    "type": "user"
                }
            }
        }
    }
}

Er wordt een nieuwe gebruiker toegevoegd aan Adobe Learning Manager.

L1-feedback plaatsen

Voorbeeld van vereiste lading:

{
    "data": {
      "id": "course:7454218_10333537_11257863",
      "type": "feedback",
      "attributes": {
        "questions": [
          {
            "answer": "8",
            "questionId": "1",
            "mandatory": true,
            "questionType": "scaleTen"
          }
        ],
        "score": 80
      }
    }
  }

Informatie op moduleniveau van een cursus ophalen

Voortgang module controleren

In de reactie krijgt u informatie over de voortgang van de module.

Imiteren van studenten

Bij het implementeren van een headless LMS met Adobe Learning Manager als back-end, kunnen organisaties ondersteuningspersoneel nodig hebben om studenten te kunnen nakomen voor probleemoplossing of hulp. De API-gestuurde imitatiemethode garandeert veilige toegang met behoud van de vertrouwelijkheid van de studentreferentie en ondersteunt naadloze overgangen in sessiestatussen.

Adobe Learning Manager vereenvoudigt het nadoen van studenten in headless LMS-omgevingen via een speciale API. Met deze functie kan ondersteuningspersoneel tijdelijk de identiteit van een student overnemen, zodat deze problemen kan diagnosticeren, functionaliteiten kan testen of praktische hulp kan bieden door de ervaring van de student te simuleren. Imitatie wordt geactiveerd met een toegangstoken voor beheerders in de cache, dat wordt gebruikt om programmatisch een toegangstoken voor studenten te genereren. Hierdoor kan het systeem werken alsof het als student is aangemeld.

API eindpuntdetails

POST /oauth/learnerToken

Volledige URL voorbeeld

https://learningmanager.adobe.com/oauth/o/learnerToken?learner_email=foo@acme.com&force=false

parameters van de Vraag:

Hoofdtekst van het verzoek:

{
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "refresh_token": "your-admin-refresh-token"
}

reactie van de Steekproef:

{
    "access_token": "generated-token",
    "refresh_token": "new-refresh-token",
    "user_role": "learner",
    "account_id": "123456",
    "user_id": "7891011",
    "expires_in": 604800
}

Steekproef cURL:

curl --location --request POST 'https://learningmanager.adobe.com/oauth/o/learnerToken?learner_email=foo@acme.com&force=false' \
--header 'Content-Type: application/json' \
--data-raw '{
  "client_id": "xxxx",
  "client_secret": "xxxx",
  "refresh_token": "xxxx"
}'

Foutcodes

Wanneer ontwikkelaars met Adobe Learning Manager (Adobe Learning Manager)-API's werken, kunnen ze verschillende HTTP-foutcodes tegenkomen tijdens aanvragen. Deze fouten geven belangrijke feedback over wat er is misgegaan en hoe deze kan worden opgelost. Als u deze codes begrijpt, kunnen ontwikkelaars snel problemen oplossen, de betrouwbaarheid van de API verbeteren en zorgen voor vloeiendere integraties. In de volgende tabel vindt u een overzicht van algemene HTTP-foutcodes die worden geretourneerd door de Adobe Learning Manager API's, samen met uitleg en typische scenario's waarin deze voorkomen. Deze sectie is essentieel voor iedereen die toepassingen bouwt, test, of zuivert die met Adobe Learning Manager verbinden.