Get a single challenge

In order to boost learner motivation, increase engagement and make educational experience more enjoyable and effective, Opigno Enterprise provides endpoints to implement challenges on your learner area. Challenges is a part of gamification. Every challenge is a set of time-limited questions that can optionally include bonus points for speed. Challenges can be created in the backoffice by administrators or content editors, and then be retrieved and processed with the API endpoints.

Challenges can not be accessed by user contexts that are not associated with any scope.

Challenge API object

Challenge object represents a single challenge data:

Parameter	Type	Description
`attempt`	`ChallengeAttempt`	Optional. The challenge attempt (if it has already been taken by the current API user).
`bonusPointsEnabled`	`Boolean`	Required. Indicator of bonus points that can be earned for the fast answer.
`cta`	`Cta`	Optional. Contains the list of challenge Call To Action objects for the current API user.
`description`	`String`	Required. A challenge description. Contains an HTML markup.
`endDate`	`Int`	Required. The timestamp when a challenge ends. The challenge will not be available for completion after this time.
`id`	`ID`	Required. A challenge ID.
`image`	`MediaImage`	Optional. A challenge image data.
`isRankingEnabled`	`Boolean`	Required. A marker to indicate if the ranking and leaderboard displaying is enabled for the challenge.
`maxChallengeRank`	`Int`	Optional. The max rank in the challenge. The value will be empty if the ranking and leaderboard displaying is not enabled for the challenge.
`participantsNumber`	`Int`	Required. The number of users who took part in the challenge and completed it.
`questionsNumber`	`Int`	Required. The total number of questions in a challenge.
`startDate`	`Int`	Required. The timestamp when a challenge starts. The challenge will not be available for completion before this time.
`status`	`ChallengeStatus`	Optional. The challenge status for the current API user (completed/ongoing/upcoming). If empty, the challenge is already finished and missed by the user.
`title`	`String`	Required. A challenge title.

Challenge CTA

The list of available CTAs can differ depending on the challenge status.

Action ID	Description	Corresponding mutation/query
`CREATE_CHALLENGE_ATTEMPT`	Allows to create a challenge attempt for the current API user. Available if the challenge is not started yet.	`createChallengeAttempt`
`VIEW_CHALLENGE`	Allows to access a challenge information.	`getChallenge`
`VIEW_CHALLENGE_RESULTS`	Allows to view a challenge results. Available when the challenge attempt is completed.	`getChallengeResult`

Retrieve a challenge from API

To retrieve a single challenge data, execute the getChallenge query. The query has one incoming argument - challengeId and returns a Challenge object if the current API user have an access to view the requested entity.

query getChallenge {
  getChallenge(challengeId: 1) {
    title
    description
    image {
      alt
      title
      url
    }
    questionsNumber
    startDate
    endDate
    bonusPointsEnabled
    participantsNumber
    maxChallengeRank
    isRankingEnabled
    status
    cta {
      actionId
      title
      arguments {
        key
        value
      }
    }
  }
}

{
  "data": {
    "getChallenge": {
      "title": "Check your geography knowledge",
      "description": "<p>How well do you know this world? Let's start this challenge and see !</p>",
      "image": {
        "alt": "Earth",
        "title": "Earth image",
        "url": "https://****.png"
      },
      "questionsNumber": 10,
      "startDate": 1770595200,
      "endDate": 1773100799,
      "bonusPointsEnabled": true,
      "participantsNumber": 5,
      "maxChallengeRank": 4,
      "isRankingEnabled": true,
      "status": "ONGOING",
      "cta": [
        {
          "actionId": "VIEW_CHALLENGE",
          "title": "See details",
          "arguments": [
            {
              "key": "challengeId",
              "value": "1"
            }
          ]
        },
        {
          "actionId": "CREATE_CHALLENGE_ATTEMPT",
          "title": "Start challenge",
          "arguments": [
            {
              "key": "challengeId",
              "value": "1"
            }
          ]
        }
      ]
    }
  }
}

Authentication

Understand the authentication requirements and how to properly authenticate your requests.

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Get a single challenge

Challenge API object

Challenge CTA

Retrieve a challenge from API

Authentication

​Challenge API object

​Challenge CTA

​Retrieve a challenge from API

​Related Features

Authentication

Challenge API object

Challenge CTA

Retrieve a challenge from API

Related Features