diff --git a/pages/qual-levels/create-a-qual-level.json b/pages/qual-levels/create-a-qual-level.json new file mode 100644 index 0000000..e7e9ede --- /dev/null +++ b/pages/qual-levels/create-a-qual-level.json @@ -0,0 +1,6 @@ +{ + "id": 24, + "name": "A Level", + "ranking": 2.0, + "custom_to_branch": true +} diff --git a/pages/qual-levels/create-a-qual-level.md b/pages/qual-levels/create-a-qual-level.md new file mode 100644 index 0000000..18ef025 --- /dev/null +++ b/pages/qual-levels/create-a-qual-level.md @@ -0,0 +1,3 @@ +### Create a Qualification Level + +Creates a new Qualification Level with the given `name` and `ranking`, linked to your Branch. diff --git a/pages/qual-levels/create-a-qual-level.py b/pages/qual-levels/create-a-qual-level.py new file mode 100644 index 0000000..3f303f1 --- /dev/null +++ b/pages/qual-levels/create-a-qual-level.py @@ -0,0 +1,5 @@ +import pprint, requests +data = {"name": "A Level", "ranking":2} +headers = {'Authorization': 'token '} +r = requests.post('https://secure.tutorcruncher.com/api/qual_levels/',json=data, headers=headers) +pprint.pprint(r.json()) diff --git a/pages/qual-levels/delete-a-qual-level.md b/pages/qual-levels/delete-a-qual-level.md new file mode 100644 index 0000000..5028e24 --- /dev/null +++ b/pages/qual-levels/delete-a-qual-level.md @@ -0,0 +1,2 @@ +### Delete a Qualification Level +Deletes a Qualification Level created by your Branch. Only the Qualification Level's unique id is required in the URL. diff --git a/pages/qual-levels/delete-a-qual-level.py b/pages/qual-levels/delete-a-qual-level.py new file mode 100644 index 0000000..b2ce4b0 --- /dev/null +++ b/pages/qual-levels/delete-a-qual-level.py @@ -0,0 +1,4 @@ +import pprint, requests +headers = {'Authorization': 'token '} +r = requests.delete('https://secure.tutorcruncher.com/api/qual_levels//', headers=headers) +pprint.pprint(r.json()) diff --git a/pages/qual-levels/get-a-qual-level.json b/pages/qual-levels/get-a-qual-level.json new file mode 100644 index 0000000..48aafa7 --- /dev/null +++ b/pages/qual-levels/get-a-qual-level.json @@ -0,0 +1,6 @@ +{ + "id": 5, + "name": "GCSE", + "ranking": 14.0, + "custom_to_branch": null +} diff --git a/pages/qual-levels/get-a-qual-level.md b/pages/qual-levels/get-a-qual-level.md new file mode 100644 index 0000000..682c7b4 --- /dev/null +++ b/pages/qual-levels/get-a-qual-level.md @@ -0,0 +1,4 @@ +### Get a Qualification Level + +Returns the details of an existing Qualification Level. You only need to specify the unique +`id` of the Qualification Level to get the correct details. diff --git a/pages/qual-levels/get-a-qual-level.py b/pages/qual-levels/get-a-qual-level.py new file mode 100644 index 0000000..f2a1a1a --- /dev/null +++ b/pages/qual-levels/get-a-qual-level.py @@ -0,0 +1,5 @@ +import pprint, requests + +headers = {'Authorization': 'token '} +r = requests.get('https://secure.tutorcruncher.com/api/qual_levels//', headers=headers) +pprint.pprint(r.json()) diff --git a/pages/qual-levels/list-all-qual-levels.json b/pages/qual-levels/list-all-qual-levels.json index 81b1b31..51de76b 100644 --- a/pages/qual-levels/list-all-qual-levels.json +++ b/pages/qual-levels/list-all-qual-levels.json @@ -6,7 +6,8 @@ { "id": 5, "name": "GCSE", - "ranking": 14.0 + "ranking": 14.0, + "custom_to_branch": null }, ... ] diff --git a/pages/qual-levels/list-all-qual-levels.md b/pages/qual-levels/list-all-qual-levels.md index c2ce52e..66d0da1 100644 --- a/pages/qual-levels/list-all-qual-levels.md +++ b/pages/qual-levels/list-all-qual-levels.md @@ -1,4 +1,3 @@ ### List all Qualification Levels -Returns of all the Qualification Levels found on your TutorCruncher account sorted by their `ids` with the -largest id first. +Returns all Qualification Levels, sorted by `id` in descending order (highest first). Includes Qualification Levels associated with your Branch, as well as default Qualification Levels (`custom_to_branch` = null). diff --git a/pages/qual-levels/qual-level-object.json b/pages/qual-levels/qual-level-object.json index 5e4ac0a..3dfbf63 100644 --- a/pages/qual-levels/qual-level-object.json +++ b/pages/qual-levels/qual-level-object.json @@ -1,5 +1,6 @@ { "id": 6, "name": "AS Level", - "ranking": 15.0 + "ranking": 15.0, + "custom_to_branch": null } diff --git a/pages/qual-levels/qual-level-object.md b/pages/qual-levels/qual-level-object.md index ad5670b..d2f32ca 100644 --- a/pages/qual-levels/qual-level-object.md +++ b/pages/qual-levels/qual-level-object.md @@ -1,4 +1,3 @@ ### Qualification Level Object -Qualification Level object contains the `id`, `name` and `ranking` for qualifications found on your -TutorCruncher account. +The Qualification Level object contains the `id`, `name`, `ranking`, and `custom_to_branch` for qualifications associated with the Branch on your TutorCruncher account. diff --git a/pages/qual-levels/qual-level-object.yml b/pages/qual-levels/qual-level-object.yml index e9e310c..9737ed3 100644 --- a/pages/qual-levels/qual-level-object.yml +++ b/pages/qual-levels/qual-level-object.yml @@ -11,3 +11,7 @@ attributes: name: ranking type: decimal description: Rank for the Qualification Level. + - + name: custom_to_branch + type: bool + description: Indicates whether the Qualification Level is specific to the your Branch (True), or is a default Qualification Level (null). diff --git a/pages/qual-levels/qual-levels.yml b/pages/qual-levels/qual-levels.yml index f3f4c99..c0be3e7 100644 --- a/pages/qual-levels/qual-levels.yml +++ b/pages/qual-levels/qual-levels.yml @@ -14,3 +14,26 @@ sections: code_type: GET code_url: /api/qual_levels/ response: /qual-levels/list-all-qual-levels.json + - + title: Get a Qualification Level + id: get-a-qual-level + description: /qual-levels/get-a-qual-level.md + code: /qual-levels/get-a-qual-level.py + code_type: GET + code_url: /api/qual-levels/ + response: /qual-levels/get-a-qual-level.json + - + title: Create a Qualification Level + id: create-a-qual-level + description: /qual-levels/create-a-qual-level.md + code: /qual-levels/create-a-qual-level.py + code_type: POST + code_url: /api/qual-levels/ + response: /qual-levels/create-a-qual-level.json + - + title: Delete a Qualification Level + id: delete-a-qual-level + description: /qual-levels/delete-a-qual-level.md + code: /qual-levels/delete-a-qual-level.py + code_type: POST + code_url: /api/qual-levels/