Example of using the Univ. of Michigan API Directory to query the MCommunity service for a person by their uniqname.

umich_mcomm_api_query.py

import os
import sys
import http.client
from base64 import b64encode
import json

clientId = os.getenv('UMICH_API_DIR_CLIENT_ID')
clientSecret = os.getenv('UMICH_API_DIR_CLIENT_SECRET')
uniqname = sys.argv[1] if len(sys.argv) > 1 else os.getenv('USER')

apiDir = http.client.HTTPSConnection('apigw.it.umich.edu')

def getApiDirAccessToken(clientId, clientSecret, scope = 'mcommunity'):
    encodedIdAndSecret = b64encode('{}:{}'.format(clientId, clientSecret).encode('UTF-8')).decode('ASCII')

    headers = {
        'Authorization': 'Basic ' + encodedIdAndSecret,
    }

    apiDir.request('POST', 'um/inst/oauth2/token?grant_type=client_credentials&scope={}'.format(scope), headers=headers)

    response = apiDir.getresponse()
    authNData = json.loads(response.read().decode('UTF-8'))

    return authNData.get('access_token')

def getMcommPersonByUniqname(uniqname, clientId, accessToken):
    headers = {
        'X-IBM-Client-ID': clientId,
        'Authorization': 'Bearer ' + accessToken,
    }

    apiDir.request('GET', '/um/MCommunity/People/{}'.format(uniqname), headers=headers)

    response = apiDir.getresponse()
    return response.read()

if '__main__' == __name__:
    accessToken = getApiDirAccessToken(clientId, clientSecret)

    if not accessToken:
        raise RuntimeError('Unable to get access token.')

    mcommunityEntry = getMcommPersonByUniqname(uniqname, clientId, accessToken)

    print(mcommunityEntry.decode('UTF-8'))