Integrations
An API for running and grading code
For a provider with its own site or app: list your coding questions, run code, hand in answers to be marked against your tests, and put a graded exercise in your own page. Each grade is posted to your webhook, signed. The full reference is public.
Training plans In the Training plans, the 30-day trial and the free plan; not in the Teacher plan. Pricing
Last checked
What it does
List your questions
Read your organisation's coding questions: the prompt, the starter code and the visible tests. Hidden tests never leave our servers.
Run code
Run a learner's code with their own input, in the question's language with its files and time limit, and get the output back. Questions may be in any of 12 languages.
Hand in for grading
Hand in an answer and it is marked against the question's tests, hidden ones included, then read the result or wait for the webhook.
Embed an exercise
Make a link for one learner that puts one graded coding exercise in your own page, for twelve hours, framed only by the site you name.
Signed webhooks
Each graded hand-in is posted to your webhook, signed so you can check it came from us, and tried again if your server does not answer.
Start
- An admin makes a key on the API page of the staff menu. It is shown once, so keep it on your server.
- Call the API over HTTPS with the key, from your server, never from a web page.
- Set your webhook address and check each post's signature, as the reference shows.
The API reference has every endpoint with examples, and the help guide covers keys and revoking them.
Questions and answers
Where is the API reference?
It is public, at theskillsite.com/developers/api: every endpoint, its errors, the webhook signature and the embed, with examples.
Do our learners need accounts?
No. Learners in the API are your own ids, with no account here. Each counts once a month as an active learner, and on the trial and the free plan towards the 30 learners.
What are the limits?
Each organisation may make 30 runs and 30 hand-ins a minute, through the API and its embeds together, and each embedded learner 10 runs and 5 hand-ins of those. Code is at most 64 KB and input 16 KB, and each hand-in has up to 10 minutes of the code runner for its tests.
Can it grade notebook questions?
No. The API and embeds leave notebook questions out and hand in one file of code.
Which plans include the API?
The Training plans, the 30-day trial and the free plan. It is not in the Teacher plan.
Try it with your next cohort
Start a 30-day free trial with up to 30 learners and no card, or see the demo for your kind of class and book a call with us.