The Schoology SDK encompasses all necessary parts, including the initial SSO SAML login request, requesting an oAuth access token, and making calls to the Schoology API. It is by no means necessary to create an application. If you don't want to use one or are writing an application not in PHP, you can take a look at them as an example for the types of operations that you will need to do.
Every Schoology user can generate unique two-legged oauth keys:
require_once('application/schoology_sdk/SchoologyApi.class.php');
$this->schoology = new SchoologyApi(SCHOOLOGY_CONSUMER_KEY, SCHOOLOGY_CONSUMER_SECRET, '', '','', TRUE);
When using the API on behalf of a Schoology Application, you must use each applications' unique oauth credentials. To find the credentials after adding an app:
When making three-legged API calls the authorization flow is more complex:
For more detailled information about Authorization be see http://developers.schoology.com/api-documentation/authentication
All calls to the API can be done using the api() function in SchoologyApi.class.php file
A response with a 20x response code means the request was successful:
Headers
HTTP/1.1 200 OK
Date: Thu, 10 Jul 2014 16:21:25 GMT
Server: Apache/2.2.20 (Ubuntu)
Vary: Host,Accept-Encoding
X-Powered-By: PHP/5.4.19-1~tooptee10+1
Last-Modified: Thu, 10 Jul 2014 16:21:25 +0000
Cache-Control: no-cache, no-store, must-revalidate, post-check=0, pre-check=0
ETag: "1405009285"
X-Schoology: API
Content-Length: 681
Access-Control-Allow-Origin: *
Connection: close
Content-Type: application/json; charset=UTF-8
Body
{
"course": [
{
"id": 1407691,
"title": "Time Travel",
"course_code": "CC106",
"department": "",
"description": "",
"credits": 0,
"subject_area": 0,
"grade_level_range_start": 12,
"grade_level_range_end": 14,
"synced": 1,
"building_id": "344232"
},
{
"id": 5410559,
"title": "FS1 Course",
"course_code": "",
"department": "",
"description": "",
"credits": 0,
"subject_area": 2,
"grade_level_range_start": 6,
"grade_level_range_end": 0,
"synced": 0,
"building_id": "5171921"
}
],
"total": "2",
"links": {
"self": "http:\/\/...\/v1\/courses?start=0&limit=20"
}
}
A response with a 40x response code means the request was unsuccessful.
For any additional information please visit http://developers.schoology.com/