Adds rich media objects (images, videos, etc.) to an existing entity.
Placeholder entities cannot be updated.
This endpoint is useful for sending in rich media such as profile pictures, ID card scans, official documents etc. that you want available for investigative and verification purposes.
Supported file types are: txt, pdf, video (mp4, mov, wmv, avi, mkv), images (png, jpg, tiff, gif, raw, eps).
The payload to this endpoint can either be a form-data or a base64 encoded media file via the requests JSON body.
Form-data sent to this endpoint must use the key media_key
and the value
as the media file. If you wish to provide optional information, use the media_key
and provide stringified JSON data as the value. There are no required fields in each media file's supplementary form data. However, if a recognized media_type
value is provided, the Unit21 system will be able to use the media object for purposes such as document verification.
--form '[email protected]/src/103031/images/document_front.jpg' \
--form 'document_front={"media_type": "IMAGE_ID_CARD_FRONT", "source": "passport_app", "timestamp": 1572673229}'
Base64 encoded media objects must follow the format:
{
"media": "iVBORw0KGgoAAAANSUhEUgAAAQMAAADCCAYAAABNEqduAAAgAElEQVR4Aey9CbgmV1Xv...",
"name": "Drivers_License.png",
"media_type": "IMAGE_DRIVERS_LICENSE_FRONT",
"custom_data": {
"internal_notes": "Reviewed by Mitchell on 31 June 2019",
"reviewers": 3,
"login": 1638384860,
"timestamp": "2012-03-40 05:12:41.000Z",
"daily_email": true,
"employees": ["John", "Anna", "Peter"],
"socure_device_session_id": "12121212121212112"
}
}
media
and name
are the only required fields for each media object. The name
must include the file extension such a File.pdf
. Supplementary form data is sent through the optional custom_data
object.
For verification purposes, recognized values of media_type
are:
media_type |
---|
IMAGE_PROFILE_PICTURE |
IMAGE_DRIVERS_LICENSE_FRONT |
IMAGE_DRIVERS_LICENSE_BACK |
IMAGE_PASSPORT_FRONT |
IMAGE_ID_CARD_FRONT |
IMAGE_ID_CARD_BACK |
IMAGE_FACE_IMAGE |