ufrgs-sdk-java

This SDK provides a simple way to communicate with the UFRGS API and its various endpoints.

Below a list of all available scopes:

SCOPES

Meus Dados this scope provides information about the user as well as their photo.
Biblioteca this scope provides information related to loans made at the UFRGS library as well as enpoints necessary for their renewal.
Caronas this scope provides all the endpoints needed for the Ufrgs Carona app [still in development]

SDK ORGANIZATION

SDK provides a manager for each of the scopes plus an additional manager for token management.

UfrgsTokenManager
UfrgsUserDataManager
UfrgsLibraryManager
UfrgsCaronasManager

Setup

1. Provide the gradle dependency

repositories {
    maven { url "https://jitpack.io" }
}

implementation 'com.github.ufrgs:ufrgs-sdk-java:1.0'

2. Initialize the SDK

Be sure to initialize your SDK before making any calls.

UfrgsAPI.initialize(
  false  /* setApiToProduction */, 
  "CLIENT_AB" /* clientId */, 
  "SECRET_AB" /* clientSecret */, 
  "SCOPE_AB" /* scope */, 
  "GRANT_AB" /* grantType */);

This information is currently restricted to UFRGS's CPD.

3. Login/Request token

requestNewToken(context /* context */, 
  "12345" /* username */,
  "password" /* password */, 
  new UfrgsTokenManager.OnTokenListener() {
    @Override
    public void onTokenReady(UfrgsToken token) {
      
      /* Token ready */
    
    }

    @Override
    public void onError(String error) {
    
      /* Handle errors */
    
    } /* callback */);

After getting the token from the user you can already initiate calls to the requested scopes.