Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

LAMS server-to-server registration and deregistration service

In case any integrations want to register all the users at one go they can use the following API.
Please note that required parameters are marked in bold.

External calls to LAMS

Add user to group lessons

You can add a user to group lessons by making a request to the Register Action on the LAMS side. For example:

http://localhost/lams/services/Register?method=addUserToGroupLessons&....

The parameters are:

  • method=addUserToGroupLessons - selfexplanatory.
  • serverId - the server id
  • datetime - a character string with the date and time you make this request (format example 2011100608:15:10)
  • hashValue - the hash value is generated using the SHA1 algorithm on the following (all in lower case) [ datetime + username + serverId + serverKey ]
  • courseId - optional parameter which stands for the id of the course from the LMS. If it's specified then user gets added to the course and its lessons, if not - just create the user.
  • lessonId - optional parameter which stands for the id of the lesson from the LMS. If it's specified then user gets added to this lesson, if not - just create the user.
  • username - the username of the user
  • firstName - his first name
  • lastName - last name
  • email - email
  • isJoinLesson - if set to 1 - then join user to lesson
  • isEmailParticipant - if set to 1 - then LAMS will email the user his/her login details
  • isEmailCoordinator - if an email confirmation to admin is required, just put the email address for the admin person here

Remove users from LMS lessons

You can remove user from group lessons by making the following request:

http://localhost/lams/services/Register?method=removeUserFromGroup&....

The parameters are:

  • method=removeUserFromGroup - selfexplanatory.
  • serverId - the server id
  • datetime - a character string with the date and time you make this request (format example 2011100608:15:10)
  • hashValue - the hash value is generated using the SHA1 algorithm on the following (all in lower case) [ datetime + username + serverId + serverKey ]
  • courseId - id of the course from the LMS
  • username - the username of the user
  • isRemoveFromAllCourses - if set to 1 - then ignores courseId parameter and removes user from all courses

Reset user's time limit

You can resets user's time limit for all lessons in a group. It will work for lessons with scheduledToCloseForIndividuals setting on, otherwise it does nothing. Request format is as follows:

http://localhost/lams/services/Register?method=resetUserTimeLimit&....

The parameters are:

  • method=resetUserTimeLimit - selfexplanatory.
  • serverId - the server id
  • datetime - a character string with the date and time you make this request (format example 2011100608:15:10)
  • hashValue - the hash value is generated using the SHA1 algorithm on the following (all in lower case) [ datetime + username + serverId + serverKey ]
  • courseId - id of the course from the LMS
  • username - the username of the user
  • No labels