RubyKhan: a Khan Academy API gem
This is a wrapper for the Khan Academy API. It is a work in progress, and only supports part of the API. Any assistance with implementing extra calls would be appreciated!
Installation
Add this line to your application's Gemfile:
gem 'rubykhan'
And then execute:
$ bundle
Or install it yourself as:
$ gem install rubykhan
Usage
So far, this gem only accesses the publically available parts of the API, but you can request an API key and use OmniAuth to authenticate users using their Khan Academy logins, and to access specific information about users. Try this Khan Academy OmniAuth gem.
In your main.rb file:
require 'rubykhan'
Information from Khan academy's API is accessed through topic keywords called "slugs" that you can use in your API requests. Topics are arranged hierarchically from the most general (e.g. "math", "science", "humanities") to the very specific.
You can see an array of all the nested topic slugs (which you can use for future queries). The default query is for 'extended_slug' which sounds gross, but which returns an array of nested topics of which you can pull out the most specific titles to look for videos and exercises:
KhanAcademy::Topic.all
You can also pass in a key and find all the titles, or the urls, or the topic slugs. For example:
KhanAcademy::Topic.all('slug')
KhanAcademy::Topic.all('title')
KhanAcademy::Topic.all('node_slug')
You can also get more information about a topic using the .get_info
method:
algebra = KhanAcademy::Topic.get_info('algebra')
algebra.title
algebra.description
algebra.ka_url
More specific topics (e.g. "differential-equations", "buddhist-art", "blood-vessels") can return videos and exercises.
buddhist_art = KhanAcademy::Playlist.get_exercises("buddhist-art")
buddhist_art.image_url
buddhist_art.prerequisites
buddhist_art.title
buddhist_art.tutorial_only
blood_vessels_videos = KhanAcademy::Playlist.get_videos("blood-vessels")
blood_vessels_videos.description
blood_vessels_videos.title
blood_vessels_videos.ka_url
To see the entire (huge) Topic Tree from Khan academy, use the Topic.tree method:
KhanAcademy::Topic.tree
More information about the Khan Academy API can be found at the Khan Academy API Explorer.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
FAQ:
Q: What's up with the name?
A: It's a pun on Crossing the Rubicon. Julius Caesar would've used Ruby in his conquest of Gaul, and we want you to be able to use Ruby in your Khan Academy app. :)