GET drillable/…/reception

Retrieves the reception of a given public drillable.

The reception consists of:

  • popularity: how many users has this drillable attracted?
  • appreciation: how is the quality of the drillable rated by users?
  • difficulty: how difficult is this drillable as perceived by its users?

Resource URL

https://www.drillster.com/api/2.1.1/drillable/{drillable_id}/reception

Parameters

Field Type Description
drillable_id
required
String The ID of the drill or course to retrieve the reception for.

Example value: eSxMA4MISaCjJA43PgMEnQ

Response

A 2.1.1 Reception object containing the reception of the drillable.

Example request

GET https://www.drillster.com/api/2.1.1/drillable/eSxMA4MISaCjJA43PgMEnQ/reception

Response

{
  "popularity": 2,
  "appreciation": {
    "points": 4,
    "score": 82
  },
  "difficulty": {
    "points": 1,
    "score": 5
  }
}

Error responses

The following error situations are possible:

ID Response code Description
missing_drillable_id 400 (Bad request) Missing or invalid drillable ID
no_access 403 (Forbidden) No access to requested drillable
not_found 404 (Not found) Requested drillable not found