API
curlNodePythonJavaRubyphpGo
API ClassOnlive
  • If you want to use the classonlive API, you will need a TOKEN

  • To obtain the token, navigate to your control panel at classonlive.com, go to the integrations section and click on the API tab. Once there, you must register the IP from which the requests will be made. The IP will be associated with a token similar to: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJjbGFzc29ubGl2ZSIsI.mRhdGEiOiJ7XC You must replace the {TOKEN} part in the routes with the token associated with your IP. You will only be able to make requests from the IP you have registered.

  • This API is designed to create webinars/live conferences/live classes. These classes in this documentation will be referred to as 'content'.

  • This API does not work with modular or pack courses.

Content
Content General

ContentObject is the object returned when making a request in this section. This object shows detailed information about the course in question. Depending on the request, the object may show more or fewer fields. In the 'Response Body' section of each request, you can see a detailed example of the fields returned by that request.

Content General Object
Attributes
  • contentId
    numberRequired
    Identifier used to delete/edit the content
  • title
    stringRequired
    Title/name of the content
  • teacher
    stringRequired
    Teacher's email
  • type
    objectRequired
    Returns a String with the type of videoconference to create
    Expand attributesClose attributes
    • Broadcast
      string
      1 teacher, up to 150 attendees
    • Many_to_Many
      string
      1 teacher, up to 9 attendees with audio/video
    • One_to_One
      string
      1 teacher, 1 attendee with audio/video
  • oneDayDate
    stringOptional
    Date transformed to String with the date of the only live session, empty if the content is of type contentDay
  • multipleDayFromDate
    stringOptional
    Date transformed to String with the start date of the course, empty if the content is only one day
  • multipleDayToDate
    stringOptional
    Date transformed to String with the end date of the course, empty if the content is one single day
  • particularInitDate
    stringOptional
    Date transformed to String with the start date of the private course, empty if the content is one single day
  • particularEndDate
    stringOptional
    Date transformed to String with the end date of the private course, empty if the content is one single day
  • contentType
    objectRequired
    Returns a String with the type of content created
    Expand attributesClose attributes
    • oneDay
      string
      Content with a live session of 1 day
    • multipleDay
      string
      Content with multiple live sessions on different days
    • particular
      string
      Content of the type private class
  • scormPath
    stringOptional
    Returns the link of the Scorm type content if it is a Scorm type course
Create a content
Url Parameters
  • token
    string
Attributes
  • title
    stringRequired
    Example: Example title
    Course title
  • type
    stringRequired
    Example: Topics
    'Measure','Modular','Topics','Private','Pack' Course type.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "Titulo de ejemplo",
    "type": "Themes"
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "contentId": 33078
}
Edit a content
Url Parameters
  • token
    string
  • contentId
    string
Attributes
  • title
    stringRequired
    Example: Example title
    Course title
  • type
    stringRequired
    Example: Topics
    'Measure','Topics','Private','Pack' Course type.
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "Titulo de ejemplo",
    "type": "Themes"
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid} \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "contentId": 33078
}
List all contents
Url Parameters
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "contentList": [
    {
        "contentId": 32957,
        "title": "Ejemplo curso un día",
        "teacher": "[email protected]",
        "oneDayDate": "2020-10-28T22:12:00.000Z",
        "multipleDayFromDate": null,
        "multipleDayToDate": null,
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "oneDay",
        "scormPath" : "enlace_curso_scorm"
    },
    {
        "contentId": 32956,
        "title": "Ejemplo curso multisesión",
        "teacher": "[email protected]",
        "oneDayDate": null,
        "multipleDayFromDate": "2020-07-23T22:00:00.000Z",
        "multipleDayToDate": "2020-08-24T22:00:00.000Z",
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "multipleDay",
        "scormPath" : "enlace_curso_scorm"
    },
    {
        "contentId": 32953,
        "title": "Ejemplo curso particular",
        "teacher": null,
        "oneDayDate": null,
        "multipleDayFromDate": null,
        "multipleDayToDate": null,
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "particular",
        "scormPath" : "enlace_curso_scorm"
    }
],
"ok": true
}
Request data for a content
Url Parameters
  • contentId
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}
Response 200
Response Headers
Content-Type: application/json
Response Body
//si es de sesión única
{
    "content": {
        "contentId": 32960,
        "title": "título curso única sesión",
        "teacher": "[email protected]",
        "oneDayDate": "2020-10-28T22:12:00.000Z",
        "durartion": "d30m",
        "type": "Broadcast"
    },
    "ok": true
}
//si es multisesión
{
    "content": {
        "contentId": 32962,
        "title": "título curso multisesión",
        "teacher": "[email protected]",
        "multipleDayFromDate": "2020-07-23T22:00:00.000Z",
        "multipleDayToDate": "2020-08-24T22:00:00.000Z",
        "type": "Broadcast",
        "dates": [
            "2020-08-20T05:30:00.000Z",
            "2020-08-13T05:30:00.000Z",
            "2020-08-06T05:30:00.000Z",
            ...
        ]
    },
    "ok": true
}
//si es particular
{
    "content": {
        "contentId": 32953,
        "title": "título de curso particular",
        "startDate": null,
        "endDate": null,
        "type": "Broadcast",
        "contentType": "Tutoring sessions"
    },
    "ok": true
}
// si es scorm 
{
    "content": {
        "contentId": 3812,
        "title": "Curso Scorm",
        "startDate": null,
        "endDate": null,
        "type": null,
        "contentType": "Scorm",
        "scormPath": "enlace_curso_scorm"
    },
    "ok": true
}
Delete content
Url Parameters
  • contentId
    string
  • token
    string
Definition
DELETE https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}
Request
Example Request
curl --request DELETE \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
"ok": true
}
Change the teacher for a content (multi-session or single session)
Url Parameters
  • contentId
    string
  • token
    string
Attributes
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/teacher
Request
Request Headers
Content-Type: application/json
Request Body
{
    "teacher": "[email protected]"
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/teacher \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Search content by title
Url Parameters
  • search
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/search/{search}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/search/{search}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
"contentList": [
    {
        "contentId": 32957,
        "title": "Ejemplo curso un día",
        "teacher": "[email protected]",
        "oneDayDate": "2020-10-28T22:12:00.000Z",
        "multipleDayFromDate": null,
        "multipleDayToDate": null,
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "oneDay"
    },
    {
        "contentId": 32956,
        "title": "Ejemplo curso multisesión",
        "teacher": "[email protected]",
        "oneDayDate": null,
        "multipleDayFromDate": "2020-07-23T22:00:00.000Z",
        "multipleDayToDate": "2020-08-24T22:00:00.000Z",
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "multipleDay"
    },
    {
        "contentId": 32953,
        "title": "Ejemplo curso particular",
        "teacher": null,
        "oneDayDate": null,
        "multipleDayFromDate": null,
        "multipleDayToDate": null,
        "type": "Broadcast",
        "particularInitDate": null,
        "particularEndDate": null,
        "contentType": "particular"
    }
],
"ok": true
}
Modify the title of a content
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • title
    stringRequired
    Example: Sample Title
    Course Title
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/title
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "nuevo título"
}

Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/title \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Single Session Content

ContentSingleSessionObject is the object returned when making a request in this section. This object shows detailed information about the course in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Single Session Content Object
Attributes
  • contentId
    numberRequired
    Identifier used to delete/edit the content
  • teacherLink
    objectRequired
    Object with a link to the video conference room
    Expand attributesClose attributes
    • ok
      booleanRequired
      Returns true if no error occurred while creating the session, otherwise returns false
    • link
      stringRequired
      Link to the video conference room
    • name
      stringRequired
      Teacher's name
    • teacher
      stringRequired
      Teacher's email
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
Create a single session content
Url Parameters
  • token
    string
Attributes
  • title
    stringRequired
    Example: Sample title
    Course title
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
  • duration
    stringRequired
    Example: d30m
    'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • session
    string
    Example: 2020
    10-28T22:12:00.000Z (string, required) - Date in the format yyyy-MM-dd'T'HH:mm:ss.SSS'Z', also accepts dates in milliseconds since 1970 e.g.: 1573035966995
  • teacher
    stringRequired
    Teacher's email
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content/oneDay
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "Titulo de ejemplo",
    "session": "2020-10-28T22:12:00.000Z",
    "teacher": "[email protected]",
    "type": "Broadcast",
    "duration": "d30m"
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content/oneDay \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "contentId": 32960,
    "teacherLink": {
        "link": "https://subdomain.classonlive.com/sala-webinar/titulo-de-ejemplo?code=ye4ll60UOoahUykx/ZhY9A==",
        "name": "teacher name",
        "email": "[email protected]",
        "ok": true
    },
    "ok": true
}
Change the session of a single session content
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • duration
    stringRequired
    Example: d30m
    'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • date
    string
    Example: 2020
    10-28T22:12:00.000Z (string, required) - Date in the format yyyy-MM-dd'T'HH:mm:ss.SSS'Z', also accepts dates in milliseconds since 1970 e.g.: 1573035966995
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/session
Request
Request Headers
Content-Type: application/json
Request Body
{
    "date": "2020-10-28T22:12:00.000Z",
    "duration": "d30m"
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/session \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Multiple Session Content

Multiple Session Content Object is the object returned when making a request in this section. This object shows detailed information about the course in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Content Multiple Session Object
Attributes
  • contentId
    numberRequired
    Example: 32966
    Identifier of the content multiple session
  • ok
    booleanRequired
    Returns true if no error occurred while creating the multiple session, otherwise returns false
Create a content of multiple session
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • title
    stringRequired
    Example: Example title
    Course title
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
  • teacher
    stringRequired
    Teacher's email
  • startDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • endDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • monday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • tuesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • wednesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • thursday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • friday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • saturday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • sunday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/multipleday
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "Título de ejemplo",
    "startDate": "2020-10-28T22:12:00.000Z",
    "endDate": "2020-11-28T22:12:00.000Z",
    "type": "Broadcast",
    "teacher":"[email protected]",
    "wednesday": {
        "hour":"02",
        "minutes":"30",
        "duration":"d15h"
        },
    "tuesday": {
        "hour":"02",
        "minutes":"30",
        "duration":"d15h"
        }
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/multipleday \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "contentId": 32966,
    "ok": true
}
Change the session of a multiple session content
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • title
    stringRequired
    Example: Sample Title
    Course Title
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
  • teacher
    stringRequired
    Teacher's email
  • startDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • endDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • monday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • tuesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • wednesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • thursday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • friday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours`
  • saturday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Sólo acepta 0, 15, 30, 45)
    • duration
      stringRequired
      Sólo acepta: 'd30m' 30 min, 'd1h' 1 hora, 'd15h' 1h 30m, 'd2h' 2 horas, 'd3h' 3 horas, 'd4h' 4 horas, 'd5h' 5 horas, 'd6h' 6 horas, 'd7h' 7 horas, 'd8h' 8 horas`
  • sunday
    object
    Objeto con propiedades
    Expand attributesClose attributes
    • hour
      stringRequired
      hora en GMT con formato HH
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/multipleday
Request
Request Headers
Content-Type: application/json
Request Body
{
    "startDate": "2020-10-28T22:12:00.000Z",
    "endDate": "2020-11-28T22:12:00.000Z",
    "type": "Broadcast",
    "teacher":"[email protected]",
    "wednesday": {
        "hour":"02",
        "minutes":"30",
        "duration":"d15h"
        }
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/multipleday \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "contentId": 32966,
    "ok": true
}
Pack

Pack type content is a content that encompasses several contents.

Add contents to a pack
Url Parameters
  • token
    string
  • contentId
    string
Attributes
  • selectedContents
    arrayRequired
    array of numbers, each number must correspond to a contentId of a 'Measure' or 'Drip' type content
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content/{contentId}/packContents
Request
Request Headers
Content-Type: application/json
Request Body
{
   "selectedContents": [33057, 33054]
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentId}/packContents \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    ok: true
}
Tutoring sessions

Tutoring sessionsObject is the object returned when making a request in this section. This object shows detailed information about the course in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Tutoring sessions Object
Attributes
  • contentId
    numberRequired
    Identifier used to delete/edit the content
  • sessions
    objectRequired
    Array of session objects
    Expand attributesClose attributes
    • sessionId
      numberRequired
      session identifier
    • teacher
      stringRequired
      Teacher's email
    • date
      stringRequired
      Session date
    • teacherLink
      stringRequired
      Access link to the session for the teacher
    • applicants
      objectRequired
      Array of student objects
      Expand attributesClose attributes
      • applicantId
        numberRequired
        student identifier
      • email
        stringRequired
        Student's email
      • name
        stringRequired
        Student's name
      • link
        stringRequired
        Access link to the session for the student
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
  • type
    objectRequired
    Returns a String with the type of videoconference to create
    Expand attributesClose attributes
    • Broadcast
      string
      1 teacher, up to 150 attendees
    • Many_to_Many
      string
      1 teacher, up to 9 attendees with audio/video
    • One_to_One
      string
      1 teacher, 1 attendee with audio/video
Create a particular content
Url Parameters
  • token
    string
Attributes
  • title
    stringRequired
    Example: Example title
    Course title
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content/particular
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "particular desde API",
    "type": "Broadcast"
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content/particular \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "contentId": 32961
}
Modify a particular content
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • title
    stringRequired
    Example: Example title
    Course title
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/content/particular/{contentId}
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title": "particular desde API",
    "type": "Broadcast"
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/content/particular/{contentId} \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "contentId": 32961
}
add/change the calendar of a particular content
Url Parameters
  • contentId
    string
  • token
    string
Attributes
  • startDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • endDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format
  • sessions
    arrayRequired
    Example: [object Object]
    Each object must have a teacher property with the teacher's email and a property for each day of the week (at least one day is required), with the name of the day in English, with an array of hours in HH:00 format corresponding to the GMT timezone
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/particular/{contentid}/calendar
Request
Request Headers
Content-Type: application/json
Request Body
{
    "startDate": "2019-11-20",
    "endDate": "2020-01-20",
    "sessions": [
        {
            "teacher":"[email protected]",
            "monday": ["12:00", "14:00"],
            "tuesday": ["13:00"]
        }
    ]
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/particular/{contentid}/calendar \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "contentId": "32951",
    "ok": true
}
Request the calendar of a particular content
Url Parameters
  • contentId
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/particular/{contentid}/calendar
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/particular/{contentid}/calendar
Response 200
Response Headers
Content-Type: application/json
Response Body
    {
        "contentId": "32951",
        "sessions": [
            {
                "sessionId": 85262,
                "teacher": "[email protected]",
                "date": "2019-11-25T12:00:00.000Z",
                "teacherLink": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=//TiEr+Mz1AYTxk1JwViRA==&claseTutoring sessionsId=85262",
                "applicants": [
                    {
                        "applicantId": 142819,
                        "email": "[email protected]",
                        "name": "pepa",
                        "link": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=goNzUM32KTAc/53SbBQhLA==&claseTutoring sessionsId=85262"
                    },
                    {
                        "applicantId": 142826,
                        "email": "[email protected]",
                        "name": "pepa",
                        "link": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=g8FK3/hKIHVHaAqRZWrjZA==&claseTutoring sessionsId=85262"
                    }
                ]
            },
            {
                "sessionId": 85263,
                "teacher": "[email protected]",
                "date": "2019-11-25T14:00:00.000Z",
                "teacherLink": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=//TiEr+Mz1AYTxk1JwViRA==&claseTutoring sessionsId=85263",
                "applicants": [
                    {
                        "applicantId": 142826,
                        "email": "[email protected]",
                        "name": "pepa",
                        "link": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=g8FK3/hKIHVHaAqRZWrjZA==&claseTutoring sessionsId=85263"
                    }
                ]
            }
        ],
        "ok": true,
        "type": "One_to_One"
    }

Themes

ThemeObject is the object returned when making a request for a theme.

Themes Object
Attributes
  • themeId
    numberRequired
    Identifier used to delete/edit the theme
  • title
    stringRequired
    Title/name of the theme
  • description
    stringOptional
    Description of the theme
Add a theme to a course
Url Parameters
  • token
    string
Attributes
  • contentId
    numberRequired
    Identifier of the content
  • title
    stringRequired
    Title/name of the theme
  • description
    stringRequired
    Description of the theme
  • order
    numberRequired
    Number used to order the themes.
  • themeId
    number
    Topic identifier in case you want to edit a topic. To create a new topic leave it empty.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/theme
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title":"Título del tema"
    "description":"Descripción del tema"
    "contentId":33079
    "order":1
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/theme \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "themeId": 38
}
Add a module to a topic
Url Parameters
  • token
    string
Attributes
  • contentId
    numberRequired
    Content identifier
  • title
    stringRequired
    Title/name of the module
  • description
    stringRequired
    Description of the module
  • order
    numberRequired
    Number used to sort the topics.
  • themeId
    numberRequired
    Identifier of the topic to which the module will be added.
  • moduleId
    number
    Module identifier in case you want to edit a module. To create a new module leave it empty.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/theme/addModule
Request
Request Headers
Content-Type: application/json
Request Body
{
    "title":"Título del módulo"
    "description":"Descripción del módulo"
    "contentId":33079,
    "themeId": 38,
    "order":1
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/addModule \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "moduleId": 38
}
Add a unique session to a module
Url Parameters
  • token
    string
Attributes
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
  • duration
    stringRequired
    Example: d30m
    'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • startDay
    string
    Example: 2020
    10-28T22:12:00.000Z (string, required) - Date in the format yyyy-MM-dd'T'HH:mm:ss.SSS'Z', also accepts dates in milliseconds since 1970 e.g.: 1573035966995
  • teacher
    stringRequired
    Teacher's email
  • moduleId
    number
    Module identifier.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/theme/setOneDaySession
Request
Request Headers
Content-Type: application/json
Request Body
{
    "duration":"d15h",
    "moduleId":11789,
    "startDay":1622373300000,
    "teacher":"[email protected]",
    "type":"Broadcast"
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/setOneDaySession \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    ok: true,
    resourceId: 32425
}
Add a unique session to a module
Url Parameters
  • token
    string
Attributes
  • type
    stringRequired
    Example: Broadcast
    'Broadcast' 1 teacher, up to 150 attendees, 'Many_to_Many' 1 teacher, up to 9 attendees with audio/video, 'One_to_One' 1 teacher, 1 attendee with audio/video
  • teacher
    stringRequired
    Teacher's email
  • startDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format or milliseconds since 1970
  • endDate
    stringRequired
    Example: 2019-11-20
    Date in YYYY-MM-DD format or milliseconds since 1970
  • monday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • tuesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • wednesday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • thursday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      hour in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • friday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • saturday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • sunday
    object
    Object with properties
    Expand attributesClose attributes
    • hour
      stringRequired
      time in GMT in HH format
    • minutes
      stringRequired
      minutes (Only accepts 0, 15, 30, 45)
    • duration
      stringRequired
      Only accepts: 'd30m' 30 min, 'd1h' 1 hour, 'd15h' 1h 30m, 'd2h' 2 hours, 'd3h' 3 hours, 'd4h' 4 hours, 'd5h' 5 hours, 'd6h' 6 hours, 'd7h' 7 hours, 'd8h' 8 hours
  • moduleId
    number
    Module identifier.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/theme/setMultipleDaySession
Request
Request Headers
Content-Type: application/json
Request Body
{
    "moduleId":11788,
    "startDate":1621591200000,
    "teacher":"[email protected]",
    "endDate":1624096800000,
    "type":"Broadcast",
    "thursday": {"duration":"d5h", "minutes": "30", "hour": "11"},
    "tuesday": {"duration": "d6h", "minutes": "30", "hour": "14"}
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/setMultipleDaySession \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    ok: true,
    resourceId: 32425
}
Request the modules of a theme
Url Parameters
  • token
    string
  • themeId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/theme/getThemeModules/{themeId}
Request
Request Headers
Content-Type: application/json
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/getThemeModules/{themeId} \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "modules": {
        134: {
            moduleId: 134,
            title: "Título del módulo",
            description: "Descripción del módulo",
            order: 1
        },
        ...
    }
}
Request the contents of a module
Url Parameters
  • token
    string
  • themeId
    string
Attributes
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/theme/getModule/{moduleId}
Request
Request Headers
Content-Type: application/json
Request Body
{
  "email": "[email protected]"
}
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/getModule/{moduleId} \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "module": [
        {
            'resourceType': 'Session',
            'resourceId': 324234,
            "initOneDayDate": null,
            "initMidLongDate": '2020-10-28T22:12:00.000Z',
            "endMidLongDate": '2020-10-28T22:12:00.000Z',
            "theContentDuration": 'd1h',
            "theContentMethod": 'Broadcast',
            "theContentType": 'Mid-Long',
            "theAssignedExpert": '[email protected]',
        },
        {
            'resourceType': 'Video'
            "resourceId": 2342,
            "title": 'título',
            "description": 'descripción'
        },
        {
            'resourceType': 'Resource',
            "resourceId": 34523,
            "title": 'título',
            "description": 'descripción'
        }
    ]
}
Content Resources
General Resource

Resource is the object returned when making a request in this section. This object shows information about the resource in question. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

General Resource Object
Attributes
  • resourceType
    stringRequired
    Resource type - ["Video","Resource",("Session" Only if the content is of type topics)]
  • title
    stringRequired
    Title/name of the resource
  • description
    stringRequired
    Description of the resource
  • resourceId
    numberRequired
    Identifier of the resource
Receive resources from a course
Url Parameters
  • token
    string
  • contentId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/getresources/{contentId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/getresources/{contentId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "courseTitle": "Titulo del curso",
    "external": null,
    "creator": 13653,
    "courseType": null,
    "own": [],
    "resources": [
        {
            "resourceType": "Video",
            "title": "vídeo nuevo",
            "description": "Esta es la descripción del vídeo",
            "resourceId": 285095
        },
        {
            "resourceType": "Resource",
            "title": "Título del recurso",
            "description": "Esta es la descripción del documento",
            "resourceId": 380443
        },...
    ],
    "contentIdentifier": "titulo-del-curo",
    "ok": true
}
Receive the link of a resource

This request will return an access link to the resource in question. The resourceType parameter only accepts the Strings (“Video”, “Resource”).

Url Parameters
  • token
    string
  • resourceType
    string
  • resourceId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/getresourcelink/{resourceType}/{resourceId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/getresourcelink/{resourceType}/{resourceId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "link": "https://www.example.com/archivo.pdf"
}
Resource topics/modules

Resource is the object returned when making a request in this section. This object shows information about the resource in question. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Resource topics/modules Object
Attributes
  • resourceType
    stringRequired
    Resource type - ["Video","Resource",("Session" Only if the content is of type topics)]
  • title
    stringRequired
    Title/name of the resource
  • description
    stringRequired
    Description of the resource
  • resourceId
    numberRequired
    Identifier of the resource
Receive resources from a module
Url Parameters
  • token
    string
  • moduleId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/theme/getmoduleresources/{moduleId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/theme/getmoduleresources/{moduleId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "courseTitle": "Titulo del curso",
    "external": null,
    "creator": 13653,
    "courseType": null,
    "own": [],
    "resources": [
        {
            "resourceType": "Video",
            "title": "vídeo nuevo",
            "description": "Esta es la descripción del vídeo",
            "resourceId": 285095
        },
        {
            "resourceType": "Resource",
            "title": "Título del recurso",
            "description": "Esta es la descripción del documento",
            "resourceId": 380443
        },
        {
            "resourceType": "Session",
            "resourceId": 614091,
            "initOneDayDate": 1621404000000,
            "initMidLongDate": null,
            "endMidLongDate": null,
            "theContentDuration": "d30m",
            "theContentMethod": "Broadcast",
            "theContentType": "One_Day",
            "theAssignedExpert": "[email protected]"
        },...
    ],
    "contentIdentifier": "titulo-del-curo",
    "ok": true
}
Receive the link of a resource from a module

This request will return an access link to the resource in question. The resourceType parameter only accepts the Strings (“Video”, “Resource”, “Session”).

Url Parameters
  • token
    string
  • resourceType
    string
  • resourceId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/getmoduleresourcelink/{resourceType}/{resourceId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/getmoduleresourcelink/{resourceType}/{resourceId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "link": "https://www.example.com/archivo.pdf"
}
VideoRecords
videoRecords

VideoRecords is the object returned when making a request in this section. This object shows detailed information about the video in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

VideoRecords Object
Attributes
  • id
    numberRequired
    Identifier used to reference the video
  • driveUrl
    stringRequired
    Link to the video on Google Drive
  • downloadLink
    stringRequired
    Link to download the video
  • users
    objectRequired
    Array of users who have access to the video; if it is not shared with any student, it returns an empty array
    Expand attributesClose attributes
    • canDownload
      booleanRequired
      Returns true if the applicant is allowed to download the video
    • applicantId
      numberRequired
      Identifier of the applicant
    • viewLink
      stringRequired
      Link to view the video
    • email
      stringRequired
      Email of the applicant
    • name
      stringRequired
      Name assigned to the applicant
  • processed
    booleanRequired
    The status of the video. True if it is processed, false if it is not yet available
  • title
    stringOptional
    Title of the video. If it has no title, it returns the field empty
  • moduleId
    numberOptional
    Module identifier if the video belongs to a modular course, otherwise returns an empty field
  • registerDate
    stringRequired
    The date when the recording was added to the course in String format
  • order
    numberOptional
    Order of the video to display
  • filename
    stringRequired
    Date transformed to String with the end date of the particular course, empty if the content is for a single day
  • downloaded
    booleanRequired
    Returns true if downloading the video is allowed, otherwise returns false
  • published
    booleanRequired
    Returns true if the video is published and accessible, otherwise returns false
  • userLinks
    objectOptional
    (ONLY when requesting recordings of an applicant). Object with the viewing and download links for that applicant
    Expand attributesClose attributes
    • canDownload
      booleanRequired
      Returns true if the applicant is allowed to download the video
    • applicantId
      numberRequired
      Applicant identifier,
    • viewLink
      stringRequired
      Link to view the video
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
Request recordings of a content
Url Parameters
  • token
    string
  • contentId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/video_records/{contentId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/video_records/{contentId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "videos": [
        {
            "driveUrl": null,
            "id": 81583,
            "downloadLink": "https://dgi92f62wujwl.cloudfront.net/54150/SampleVideo_1280x720_10mbs.mp4",
            "users": [
                {
                    "canDownload": true,
                    "email": "[email protected]",
                    "name": "example",
                    "applicantId": 644,
                    "viewLink": "https://subdomain.classonlive.com/sala-video/therealtest-4&own&3&Z1e3YzxFffxA5Z385h58/w=="
                }
                ...
            ],
            "processed": true,
            "title": null,
            "moduleId": null,
            "order": 1,
            "registerDate": "2019-11-04",
            "filename": "54150/SampleVideo_1280x720_10mbs.mp4",
            "downloaded": false,
            "published": false
        },
        {
            "driveUrl": null,
            "id": 81584,
            "downloadLink": "https://dgi92f62wujwl.cloudfront.net/54151/IntercoachGroup21552475760317/IntercoachGroup21552475760317.m3u8",
            "users": [
                {
                    "canDownload": true,
                    "email": "[email protected]",
                    "name": "example",
                    "applicantId": 644,
                    "viewLink": "https://subdomain.classonlive.com/sala-video/therealtest-4&own&3&Z1e3YzxFffxA5Z385h58/w=="
                }
                ...
            ],
            "processed": true,
            "title": null,
            "moduleId": null,
            "order": 1,
            "registerDate": "2019-11-04",
            "filename": "IntercoachGroup21552475760317/IntercoachGroup21552475760317.m3u8",
            "downloaded": false,
            "published": false
        },
        ...
    ],
    "ok": true
}

Request recordings of an applicant
Url Parameters
  • contentId
    string
  • token
    string
  • applicantId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/video_records/{contentId}/{applicantId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/video_records/{contentId}/{applicantId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "videos": [
        {
            "driveUrl": null,
            "id": 81583,
            "processed": true,
            "title": null,
            "moduleId": null,
            "order": 1,
            "registerDate": "2019-11-04",
            "filename": "54150/SampleVideo_1280x720_10mbs.mp4",
            "userLinks": {
                "downloadLink": "https://dgi92f62wujwl.cloudfront.net/54150/SampleVideo_1280x720_10mbs.mp4", // Enlace del vídeo para descargar
                "canDownload": true, // Devuelve true si el applicant tiene permitido la descarga del vídeo
                "viewLink": "https://subdomain.classonlive.com/sala-video/therealtest-4&own&81583&BctkcZnlr+GUfIDab42L/g==" // Enalce para visualizar el vídeo
            },
            "downloaded": true,
            "published": true
        }
    ],
    "ok": true
}

Share a video with a student
Url Parameters
  • token
    string
Attributes
  • videoId
    numberRequired
    Example: 50
    Video identifier
  • appList
    objectRequired
    Array of objects containing the applicants with whom the video is to be shared
    Expand attributesClose attributes
    • applicantId
      numberRequired
      Example: 1938
      Identifier of the applicant with whom you want to share the video
    • downloadable
      booleanOptional
      True if you want the applicant to also be able to download the video
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/video_records/publishvideo
Request
Request Headers
Content-Type: application/json
Request Body
{
    "videoId": 50,
    "appList": [{
        "applicantId": 1938, // Identificador del applicant
        "downloadable": true // True para permitir applicant la descarga del vídeo
    },
    {
        "applicantId": 1937,
        "downloadable": true
    }]

}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/video_records/publishvideo \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "video": {
        "driveUrl": null,
        "downloadLink": "https://dgi92f62wujwl.cloudfront.net/54150/SampleVideo_1280x720_10mbs.mp4",
        "title": null,
        "processed": true,
        "donwloaded": false,
        "moduleId": null,
        "order": 1,
        "registerDate": "2019-11-04",
        "videoId": 81583,
        "filename": "54150/SampleVideo_1280x720_10mbs.mp4",
        "published": false,
        "users": [
            {
                "canDownload": true, // Devuelve true si el applicant tiene permitido la descarga del vídeo
                "applicantId": 142836, // Identificador del applicant
                "viewLink": "https://subdomain.classonlive.com/sala-video/therealtest-4&own&81583&L80POO/O9RX1z3Wle242xg==" // Enalce para visualizar el vídeo
            },
            ...
        ]
    }
}
Unpublish a video for a student
Url Parameters
  • token
    string
Attributes
  • videoId
    stringRequired
    Example: 81233
    The identifier of the video
  • appList
    objectRequired
    Array with identifiers of students (applicantId)
    Expand attributesClose attributes
    • applicantId
      stringRequired
      Identifier of the applicant
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/video_records/unpublishvideo
Request
Request Headers
Content-Type: application/json
Request Body
{
"videoId": 81583,
    "appList": [
        142836,
        ...
    ]
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/video_records/unpublishvideo \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "video": {
        "driveUrl": null,
        "downloadLink": "https://dgi92f62wujwl.cloudfront.net/54150/SampleVideo_1280x720_10mbs.mp4",
        "title": null,
        "processed": true,
        "donwloaded": true,
        "moduleId": null,
        "order": 1,
        "registerDate": "2019-11-04",
        "videoId": 81583,
        "filename": "54150/SampleVideo_1280x720_10mbs.mp4",
        "published": true
    }
}
Users
General Users

ApplicantObject is the object returned when making a request in this section. This object shows detailed information about the user in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

General Users Object
Attributes
  • name
    string
    The username
  • newEmail
    string
    The new email in case of email change
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
Request the name of a user
Url Parameters
  • email
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/username/{email}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/username/{email}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "name": "nombre",
    "ok": true
}
Modify a user's name
Url Parameters
  • email
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/username/{email}
Request
Request Headers
Content-Type: application/json
Request Body
{
    "email": "[email protected]",
    "name": "name example"
}
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/username/{email} \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Modify a user's email
Url Parameters
  • token
    string
Attributes
  • email
    stringRequired
    `The user's email (student or teacher of your academy)`
  • newEmail
    stringRequired
    The new email
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/useremail
Request
Request Headers
Content-Type: application/json
Request Body
{
    "email": "[email protected]",
    "newEmail": "[email protected]"
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/useremail \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "newEmail": "[email protected]",
    "ok": true
}
Applicant/student

ApplicantObject is the object returned when making a request in this section. This object shows detailed information about the student(s) in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Applicant/student Object
Attributes
  • applicantId
    number
    Student identifier
  • email
    string
    Student email
  • link
    string
    Link to join the live session for the student
  • name
    string
    Student name
  • students
    object
    Array of course student objects
    Expand attributesClose attributes
    • name
      string
      Student name
    • email
      string
      Student email
    • content
      string
      Course name
    • contentId
      number
      Course identifier
    • applicantId
      number
      Student identifier
  • applicants
    object
    array of student objects for private session
    Expand attributesClose attributes
    • name
      string
      Student name
    • email
      string
      Student email
    • link
      string
      Link to join the live session for the student
    • applicantId
      number
      Student identifier
  • isNewUser
    boolean
    True if the user is new in the database and requires a new password
  • password
    string
    Password (Only if isNewUser is true)
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
Search among your students, search by name or email
Url Parameters
  • search
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/student/search/{search}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/student/search/{search}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "students": [
        {
            "name": "nombre ejemplo",
            "email": "[email protected]",
            "content": "título content",
            "contentId": 20940,
            "applicantId": 115218
        },
        ...
    ]
}
Add a student to a content
Url Parameters
  • token
    string
Attributes
  • contentId
    numberRequired
    The identifier of the content
  • email
    stringRequired
    The email of the student
  • name
    stringRequired
    The name of the student
  • themes
    arrayOptional
    Only for when the course is by topics/modules. Contains an array of Strings with the topics to which a student wishes to be added. If no topics are specified, the student is added with all available course topics.
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/content/student
Request
Request Headers
Content-Type: application/json
Request Body
{
    "email": "[email protected]",
    "contentId": 32960,
    "name": "nombre alumno",
    "themes": ["34","40"] // Opcional, para añadir al alumno a un tema/as en concreto. Si no se añade la clave "themes" se añadirá al alumno con todos los temas
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/content/student \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "link": "https://subdomain.classonlive.com/sala-webinar/titulo-de-ejemplo?code=Xs9JH7T/neCiFL93TWAQfQ==",
    "name": "nombre alumno",
    "email": "[email protected]",
    "applicantId": 142829,
    "ok": true,
    "isNewUser": true,
    "password": "8476235" //sólo si es usuario nuevo
}
Remove a student from a content (multi-session or single session)
Url Parameters
  • token
    string
Attributes
  • contentId
    stringRequired
    The identifier of the content
  • email
    stringRequired
    The email of the student
Definition
DELETE https://www.apiclassonlive.com/api/v1/{token}/content/student
Request
Request Headers
Content-Type: application/json
Request Body
{
    "email": "[email protected]",
    "contentId": 32960
}
Example Request
curl --request DELETE \
--url https://www.apiclassonlive.com/api/v1/{token}/content/student \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "contentId": 32960,
    "email": "[email protected]"
}
Request data for a student (multi-session or single session)
Url Parameters
  • contentId
    string
  • token
    string
  • email
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/email/{email}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/content/{contentid}/email/{email}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "link": "https://subdomain.classonlive.com/sala-webinar/titulo-de-ejemplo?code=Xs9JH7T/neCiFL93TWAQfQ==",
    "name": "nombre alumno",
    "email": "[email protected]",
    "applicantId": 142831,
    "ok": true
}
Add student(s) to a particular content session
Url Parameters
  • sessionId
    string
  • token
    string
Attributes
Definition
PUT https://www.apiclassonlive.com/api/v1/{token}/particular/{sessionid}/addstudent
Request
Request Headers
Content-Type: application/json
Request Body
{
    "students": [
        {
            "email":"[email protected]",
            "name":"nombre"
        },
        ...
    ]
}
Example Request
curl --request PUT \
--url https://www.apiclassonlive.com/api/v1/{token}/particular/{sessionid}/addstudent \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "applicants": [
        {
            "applicantId": 142834,
            "email": "[email protected]",
            "name": "nombre",
            "link": "https://subdomain.classonlive.com/sala-personalizada/title-18?code=g8FK3/hKIHVHaAqRZWrjZA==&claseTutoring sessionsId=85468"
        }
    ],
    "ok": true
}
Remove student from a particular content session
Url Parameters
  • sessionId
    string
  • token
    string
Attributes
Definition
DELETE https://www.apiclassonlive.com/api/v1/{token}/particular/{sessionid}/removestudent
Request
Request Headers
Content-Type: application/json
Request Body
{
    "applicantId": 23734
}
Example Request
curl --request DELETE \
--url https://www.apiclassonlive.com/api/v1/{token}/particular/{sessionid}/removestudent \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Request the students of a content
Url Parameters
  • contentId
    string
  • token
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/student/findbycontent/{contentid}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/student/findbycontent/{contentid}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "students": [
        {
            "minutesConnected": 0,
            "attended": false,
            "email": "[email protected]",
            "applicantId": 142832,
            "name": "nombre alumno",
            "userAccountId": 93098,
            "themes": "49780", // Si el alumno está apuntado a todos los temas el valor de "Themes" devolverá null, de lo contrario devolverá un String con los temas individuales adquiridos
        }
    ],
    "ok": true
}
Teachers

TeacherObject is the object returned when making a request in this section. This object shows detailed information about the teacher in question. Depending on the request, the object may show more or fewer fields. In the “Response Body” section of each request, a detailed example of the fields returned by that request can be seen.

Teachers Object
Attributes
  • isNewUser
    boolean
    True if the user is new in the database and requires a new password password: (string) - Password (Only if isNewUser is true)
  • ok
    booleanRequired
    Returns true if no error has occurred, otherwise returns false
Add a teacher to your academy
Url Parameters
  • token
    string
Attributes
Definition
POST https://www.apiclassonlive.com/api/v1/{token}/teacher
Request
Request Headers
Content-Type: application/json
Request Body
{
    "email": "[email protected]"
}
Example Request
curl --request POST \
--url https://www.apiclassonlive.com/api/v1/{token}/teacher \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true,
    "isNewUser": true,
    "paswword": "672773" //sólo si es usuario nuevo
}
Delete a teacher from your academy
Url Parameters
  • token
    string
Attributes
Definition
DELETE https://www.apiclassonlive.com/api/v1/{token}/teacher
Request
Request Headers
Content-Type: application/json
Request Body
{
    "teacher": "[email protected]"
}
Example Request
curl --request DELETE \
--url https://www.apiclassonlive.com/api/v1/{token}/teacher \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "ok": true
}
Progress

These methods return an object called “general” where the overall progress of each student appears and a “detail” object where the detailed progress of each resource of the student appears.

Request the progress of the students of a content

Method that returns the progress of students in a specific course. The parameter pageNumber is optional and is used for pagination. E.g.: 0 -> the first 10 students, 1 -> the next 10 students.

Url Parameters
  • contentId
    string
  • token
    string
  • pageNumber
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/student/getstatsfromcontent/{contentid}/{pageNumber?}
Request
Example Request
curl --request GET \
--url 'https://www.apiclassonlive.com/api/v1/{token}/student/getstatsfromcontent/{contentid}/{pageNumber?}='
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "stats": [
        {
            "general": {
                "progressPictureId": 16975101,
                "name": "nombre alumno",
                "registerDate": 1604331250000,
                "totalPercent": 33.33,
                "totalTime": 0,
                "applicantId": 1504891,
                "contentId": 123035,
                "email": "[email protected]",
                "register": 1604358000000,
                "country": null,
                "photo": null,
                "score": null,
                "status": null
            },
            "detail": [
                {
                    "progressPictureDetailId": 774634764,
                    "examTries": 0,
                    "name": "evaluacion",
                    "percent": null,
                    "resourceType": "exam",
                    "success": false,
                    "time": null,
                    "watched": false,
                    "moduleId": 111053,
                    "themeId": 24913,
                    "applicantId": 1504891,
                    "contentId": null,
                    "examId": 18551,
                    "resourceId": null,
                    "contentSessionId": null,
                    "contentExternalVideoId": null
                },
            ]
        }
    ],
    "num": 0,
    "totalPages": 1
}
Request the progress of the student for a specific content
Url Parameters
  • token
    string
  • contentId
    string
  • applicantId
    string
Definition
GET https://www.apiclassonlive.com/api/v1/{token}/student/getuserstats/{contentid}/{applicantId}
Request
Example Request
curl --request GET \
--url https://www.apiclassonlive.com/api/v1/{token}/student/getuserstats/{contentid}/{applicantId}
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "progress":
        {
            "general": [
                {
                    "progressPictureId": 16975101,
                    "name": "nombre alumno",
                    "registerDate": 1604331250000,
                    "totalPercent": 33.33,
                    "totalTime": 0,
                    "applicantId": 1504891,
                    "contentId": 123035,
                    "email": "[email protected]",
                    "register": 1604358000000,
                    "country": null,
                    "photo": null,
                    "score": null,
                    "status": null
                },
            ]
            "detail": [
                {
                    "progressPictureDetailId": 774634764,
                    "examTries": 0,
                    "name": "eva",
                    "percent": null,
                    "resourceType": "exam",
                    "success": false,
                    "time": null,
                    "watched": false,
                    "moduleId": 111053,
                    "themeId": 24913,
                    "applicantId": 1504891,
                    "contentId": null,
                    "examId": 18551,
                    "resourceId": null,
                    "contentSessionId": null,
                    "contentExternalVideoId": null
                },
            ]
        }
    ],
    "num": 0,
    "totalPages": 1
}
Examples
Create content by topics/modules

Pincha here to see an example of how to create a course by topics.