README

A PHP client library for interacting with the OneRoster API. This library simplifies authentication and API calls, making it easy to integrate OneRoster-compliant systems.

OneRoster PHP API is a significantly modified version of Sky API OneRoster, originally developed by Groton School.

Features

• OAuth1 authentication with client credentials.
• Easy-to-use interface for interacting with OneRoster endpoints.
• Supports fetching organizations and other OneRoster entities.
• Supports OneRoster version 1.1

Installation

To install the package, use Composer:

composer require blps/oneroster-php-api

Usage

Initialize the Client

require 'vendor/autoload.php';

use BLPS\OneRosterAPI\Client\OneRosterClient;
use BLPS\OneRosterAPI\OneRosterAPI;

$clientId = 'your-client-id';
$clientSecret = 'your-client-secret';
$baseUrl = 'https://example.com';

$client = new OneRosterClient($clientId, $clientSecret, $baseUrl);
$api = new OneRosterAPI($client);

Fetch Organizations

Get a list of organizations

$orgs = $api->orgs->get();
print_r($orgs);

Get a single organization

$org = $api->orgs->getOne('10');
print_r($org);

Requirements

• PHP 8.2 or later
• Composer

Changes

This version of OneRoster PHP API includes significant modifications and improvements, including:

• Refactored Codebase – Improved structure and readability for better maintainability.
• Enhanced API Support – Improved handling of OneRoster-compliant requests and responses.
• ClassLink Support – Added the ability to work with the ClassLink OneRoster API.

License

This project is licensed under the GNU GPL-3.0.
It is based on Sky API OneRoster, which is also licensed under GPL-3.0.

Contributing

Pull requests are welcome! If you find an issue, please open an issue on GitHub.

Contact

For any questions or support, please create an issue in the repository.

Acknowledgment

Special thanks to Groton School for their original work on Sky API OneRoster.