1. Embedding / integrating courses using LTI (Learning Tools Interoperability specification)

There is a separate article about LTI (Learning Tools Interoperability specification) and how to use it with Easygenerator courses.

2. Using URL parameters 

Note: This method works in the Simple course template only when the “save progress cross device” setting is disabled. If the “save progress cross device” is enabled – please use the progress storage API (the 2nd chapter of this article).

If you want to get rid of the log-in screen but still register the users’ results, you can create a personalized link to the courses you’ve created.

Default URL of the course looks this way:

https://elearning.easygenerator.com/d8dcb950-400f-437f-92ad-787e941ca2e9

To create a personalized link, you need to add the learners' name and email to the default link in the address bar. Afterwards, the URL with learners’ credentials will look this way:

https://elearning.easygenerator.com/d8dcb950-400f-437f-92ad-787e941ca2e9/?name=John&[email protected]#

3. Using the Progress storage API

Note: This method works in the Simple course template only when the “save progress cross device” setting is enabled. If the “save progress cross device” is disabled – please use the URL parameters method.

If you want to get rid of the login screen but still register the users’ results and to give your users an option to continue from the place they left off, there is Easygenerator progress storage API.

Below you will find the following API details:

  • Register a new user API method
  • Get a new token API method
  • How to use a token

Register a new user

POST https://progress-storage.easygenerator.com/user/register

Request content type: application/json

Request body parameters:

  • email: User's email;
  • name: User's name;
  • password: User's password;
  • blockEmailSending: Disabling sending emails to the user (for example: true or false).

Response body parameters:

  • token: Token, which allows to log-in (tokens are valid for 30 days from the date of the generation).

Get a new token

POST https://progress-storage.easygenerator.com/user/signin

Request content type: application/json

Request body parameters:

  • email: User's email
  • password: User's password

Response body parameters:

  • token: Token, which allows to log in

How to use a token

A token can be pushed to a query string. Use the following URL template to login a user to a course and have his/her progress restored:

[courseLink]?token=[token]

Note: Tokens are valid for 30 days from the date of the generation. When a token expires, a new one can be generated using the get token (login) API.

Check if user exists

POST https://progress-storage.easygenerator.com/user/exists

Request content type: application/json

Request body parameters:

  • email: User's email

Response body parameters:

  • 204: User doesn't exists
  • 409: User exists

Send forgot password link

POST https://progress-storage.easygenerator.com/user/forgotpassword

Request content type: application/json

Request body parameters:

  • email: User's email

Response body parameters:

  • 200: Email have been sent

Note: In the Test (Assessment) template you can set up the single sign-on via URL only.

Did this answer your question?