Desire2Learn价态接口用户ID

Question

获取以下价级API中使用的用户ID的首选方法是什么？

PUT /d2l/api/le/(D2LVERSION:版本)/(D2LID: orgUnitId)/grades/(D2LID: gradeObjectId)/values/(D2LID: userId)

这里的用户id是否与身份验证过程中收到的令牌ID相同，或者您调用的是“received”API，还是其他什么？

Answer 1

“UserContext”调用提供您正在使用的当前令牌值(在身份验证步骤中返回的标记值)的数据。例如，如果您以管理员身份登录，则会返回管理员的userId。

WhoAmI API Call

GET /d2l/api/lp/(D2LVERSION: version)/users/whoami

这将为您提供有关当前UserContext的信息

{
    "Identifier": "<string:D2LID>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "UniqueName": "<string>",
    "ProfileIdentifier": "<string:D2LID>"
}

如果您正在查找特定orgUnit中的用户的UserIds，我将进行以下调用：

Classlist API Call

GET /d2l/api/le/(D2LVERSION: version)/(D2LID: orgUnitId)/classlist/

这将为您提供一个ClasslistUsers数组

{
    "Identifier": "<string:D2LID>",
    "ProfileIdentifier": "<string:D2LID>",
    "DisplayName": "<string>",
    "UserName": "<string>|null",
    "OrgDefinedId": "<string>|null",
    "Email": "<string>|null"
}

这两种情况下的"Identifier“值都是您想要使用的值(D2LID:UserId)