studip 1.0.0

A simple-to-use wrapper for Stud.IP's RestAPI service in Dart.

example/studip_example.dart

import 'dart:convert';
import 'dart:io';

import 'package:studip/studip.dart' as studip;

void main() {
  // Initialize client
  var client = studip.StudIPClient(
      'https://studip.uni-passau.de/studip/dispatch.php/api',
      'CONSUMER_KEY',
      'CONSUMER_SECRET');
  // TODO Replace CONSUMER_KEY and CONSUMER_SECRET
  client.getAuthorizationUrl('example://oauth_callback').then((url) {
    // Get verifier by calling the returned link and approve access
    print('Open URL in browser: $url');
    return stdin.readLineSync();
    // or e.g. return FlutterWebAuth.authenticate(url: url, callbackUrlScheme: 'example');
  }).then((res) {
    // Retrieve permanent token
    final verifier = Uri.parse(res).queryParameters['oauth_verifier'];
    return client.retrieveAccessToken(verifier);
  }).then((v) {
    // Example call
    return client.get('https://studip.uni-passau.de/studip/api.php/user');
  }).then((body) {
    // Example parsing of response
    final decoded = json.decode(body);
    print(decoded['name']['formatted']);
  });
}