GET playable/…

Retrieves playable details.

A playable is any object that can be played in the Drillster widget, i.e. a drill, course or test.

Resource URL

https://www.drillster.com/api/2.1.1/playable/{playable_id}

Parameters

Field Description
playable_id
required
The unique ID of the playable.

Example value: 5YiBVXMMkIB6FmcLssQ74Q
versionResolvingStrategy
optional
The strategy to resolve the version if the playable supports versioning (drills and stories), and playable_id does not refer to a specific version.

  • WORKING_VERSION
  • MOST_RECENTLY_RELEASED_VERSION
  • MOST_RECENT_VERSION
  • MOST_RECENT_ACCESSIBLE_VERSION (default)

Response

A 2.1.1 Playable object.

Error responses

The following error situations are possible:

ID Response code Description
missing_playable_id 400 (Bad request) No playable ID given.
no_playable_access 403 (Forbidden) Caller is not permitted to retrieve these playable details.
no_permission 401 (Unauthorized) Caller is not permitted to retrieve these playable details.
not_found 404 (Not found) Requested playable was not found.
illegal_playable_id_type 400 (Bad request) Both a versionResolvingStrategy and a versioned playable_id were specified
invalid_version_resolving_strategy 400 (Bad request) The specified versionResolvingStrategy is invalid