shalvah/unnportal-api

Authenticate and get details about your users as UNN students

1.2.0 2017-01-29 10:52 UTC

This package is auto-updated.

Last update: 2024-12-12 05:26:06 UTC


README

UNN logo

unnportal-php

PHP library for the UNN API

Latest Stable Version Total Downloads License

Authenticate and get details about your application's users through their unnportal details. With this, you can restrict your app's audience to the right people.

Usage:

<?php

use \UnnPortal\Portal;
use \UnnPortal\PortalException;

require 'vendor/autoload.php';

$username = "2013/1xxxxx";
$password = "xxxxxx";

try {
    $student = Portal::authenticate($username, $password);
    echo "Hi there, $student->first_name from the department of $student->department!";
} catch (PortalException $e) {
    echo $e->getMessage();
}

The authenticate method returns an instance of \UnnPortal\Student if successful, or throws a PortalException if not.

For a list of available student details, see the documentation at https://github.com/shalvah/unn-api

Installation:

Run composer install shalvah/unnportal-api.

Contribution

Wanna help improve this package? Thanks! All you need to do:

  • Fork the project
  • Clone your fork to your local machine
  • Make your changes
  • Commit your changes and push
  • Open a pull request I'll attend to all PRs as soon as I can!

If you like this...

Please star and share! Thanks!