Skip to content

Latest commit

 

History

History
124 lines (88 loc) · 4.91 KB

AcademicSessionsManagementApi.md

File metadata and controls

124 lines (88 loc) · 4.91 KB

OneRosterClient::AcademicSessionsManagementApi

All URIs are relative to /

Method HTTP request Description
get_academic_session GET /academicSessions/{sourcedId} The REST read request message for the getAcademicSession() API call.
get_academic_sessions GET /academicSessions The REST read request message for the getAcademicSessions() API call.

get_academic_session

SingleAcademicSessionType get_academic_session(sourced_id)

The REST read request message for the getAcademicSession() API call.

To read, get, a specific academic session.

Example

# load the gem
require 'oneroster_client'
# setup authorization
OneRosterClient.configure do |config|
  # Configure OAuth2 access token for authorization: OAuth2Security
  config.access_token = 'YOUR ACCESS TOKEN'
end

api_instance = OneRosterClient::AcademicSessionsManagementApi.new
sourced_id = 'sourced_id_example' # String | The unique identifier for this academic session.


begin
  #The REST read request message for the getAcademicSession() API call.
  result = api_instance.get_academic_session(sourced_id)
  p result
rescue OneRosterClient::ApiError => e
  puts "Exception when calling AcademicSessionsManagementApi->get_academic_session: #{e}"
end

Parameters

Name Type Description Notes
sourced_id String The unique identifier for this academic session.

Return type

SingleAcademicSessionType

Authorization

OAuth2Security

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

get_academic_sessions

MultipleAcademicSessionsType get_academic_sessions(opts)

The REST read request message for the getAcademicSessions() API call.

To read, get, a collection of academic sessions i.e. all academic sessions.

Example

# load the gem
require 'oneroster_client'
# setup authorization
OneRosterClient.configure do |config|
  # Configure OAuth2 access token for authorization: OAuth2Security
  config.access_token = 'YOUR ACCESS TOKEN'
end

api_instance = OneRosterClient::AcademicSessionsManagementApi.new
opts = { 
  limit: 100, # Integer | To define the download segmentation value i.e. the maximum number of records to be contained in the response.
  offset: 0, # Integer | The number of the first record to be supplied in the segmented response message.
  continuation_token: 'continuation_token_example', # String | Allows the client to resume retrieving results from where the previous page left off
  sort: 'sort_example', # String | Identifies the sort criteria to be used for the records in the response message. Use with the orderBy parameter.
  order_by: 'order_by_example', # String | The form of ordering for response to the sorted request i.e. ascending (asc) or descending (desc).
  filter: 'filter_example', # String | The filtering rules to be applied when identifying the records to be supplied in the response message.
  fields: ['fields_example'] # Array<String> | To identify the range of fields that should be supplied in the response message.
}

begin
  #The REST read request message for the getAcademicSessions() API call.
  result = api_instance.get_academic_sessions(opts)
  p result
rescue OneRosterClient::ApiError => e
  puts "Exception when calling AcademicSessionsManagementApi->get_academic_sessions: #{e}"
end

Parameters

Name Type Description Notes
limit Integer To define the download segmentation value i.e. the maximum number of records to be contained in the response. [optional] [default to 100]
offset Integer The number of the first record to be supplied in the segmented response message. [optional] [default to 0]
continuation_token String Allows the client to resume retrieving results from where the previous page left off [optional]
sort String Identifies the sort criteria to be used for the records in the response message. Use with the orderBy parameter. [optional]
order_by String The form of ordering for response to the sorted request i.e. ascending (asc) or descending (desc). [optional]
filter String The filtering rules to be applied when identifying the records to be supplied in the response message. [optional]
fields Array<String> To identify the range of fields that should be supplied in the response message. [optional]

Return type

MultipleAcademicSessionsType

Authorization

OAuth2Security

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json