Use Case: Upload a Photo for a Cardholder

If necessary, Authenticate

If necessary, Client Registration

Check if the cardholder exists in CloudCard

1. Get a Person using findBy=email or findBy=identifier. For example,

   1. https://api.onlinephotosubmission.com/person/jon.doe@foo.edu?findBy=email

   2. https://api.onlinephotosubmission.com/person/A1234567?findBy=identifier

2. If the cardholder exists the request will return 200 OK. If not, it will return 404 NOT FOUND.

If the cardholder does not exist, create the cardholder.

Create a photo for the cardholder.

Process the photo (separate requests; in order). Use the URL stored in the links.bytes field in the response to retrieve the processed photo.

1. { "process": "rotate" }

2. { "process": "crop" }

3. { "process": "removeBackground" }

4. { "process": "classify" }

5. { "process": "sendFeedback" }