Application Programming Interface

Path Parameter API Endpoint

Returns the profile image for the specified user. The endpoint dynamically selects the image file based on the {user} and {imageSource} path parameters. The returned file is a standard image (JPEG/PNG), but the server determines which image to serve at request time.

GET /Assets/Images/{user}/{imageSource}

Parameters

user
Type string
Source URI
Description The user being referenced.
Users' email prefix (e.g. Alex.Haberer - [email protected])

imageSource
Type string
Source URI
Description The source of the image requested.
../PublicImage,
../PublicImage_Thumbnail,

Due to authorization requirements to use Blackboard images externally, the user(s) Blackboard image can manuallybe set as their public image. This then bypasses secondary authorization following the HTTPS Endpoint requests.

../Blackboard.jpg,
../Blackboard_PublicWebsite.jpg,
../Blackboard_Thumbnail.jpg,
../DigitalMeasures.jpg,
../DigitalMeasures_PublicWebsite.jpg,
../DigitalMeasures_Thumbnail.jpg,
../Marketing.jpg,
../Marketing_PublicWebsite.jpg,
../Marketing_Thumnail.jpg
Returns

A dynamically selected image if found, otherwise a placeholder image.

Example(s)

*Returns Public Image

*Max Width: 140px x Max Height: 140px (Keeps Ratio)

https://usd-asp.usd.edu/directory-image-management/Assets/Images/Alex.Haberer/PublicImage

Query Parameter API Endpoint

GET /api/image

Retrieves the image associated with a specific user ID. This endpoint is fully dynamic, using the id parameter to locate the user and the hashValue for authorization. The server chooses the appropriate image file (e.g., Blackboard.jpg) or returns a fallback placeholder if no file exists.

Access Restrictions

External access to images of source type "Blackboard" requires secondary authorization and Compliance Officer approval.

Secret Key / Hash Required

Parameters

id
Type string
Source URI
Description The user id being referenced.

hashValue
Type string
Source URI
Description The hash of the user id and secret key supplied by ITS.
Example(s)

*Returns Blackboard Image

*Full Size

https://usd-asp.usd.edu/directory-image-management/api/image?id={{id}}&hashValue={{hashValue}}