Upload an image file, and perform EXPLO's default photo ID transformation on it.

Expects the request body to contain the following data:

• file - The actual photo file you're uploading
• entity_id - probably participant_uuid or similar identifier
• name - name of the human
• redirect_url - (optional) - URL for redirection on successful post.

On success, returns JSON in the same format as show/2.

Show a photo ID form for people to fill out.

Expects the request query to contain a data parameter that is encoded using Utility.Text.url_conceal/1 format (base 64-encoded JSON), with the following structure:

{
  "entity_id" : "probably participant_uuid",
  "name" : "Participant Name",
  "redirect_url" : "(optional) url for redirect when upload is successful"
}

If the query does not include the proper format, an error is thrown.

Return photo info from an id, with optional transformation.

The id in question is the public_id of the photo resource (in 2021, that's the Cloudinary public ID).

On success, returns JSON in the following format:

{
  "public_id" : "id",
  "url" : "https://res.cloudinary.com/etc",
  "resource" : {...}
}

...where the resource key is a JSON blob that looks like the result of Z.Photos.get_photo/1.

Parameters

• transformation (optional String) - any transformation option from Z.Photos.transformation_url/2. If this is passed, the url key of the response will be updated with a URL to the transformed photo.