Skip to main content

OperationsApi

All URIs are relative to http://localhost

MethodHTTP requestDescription
checkImagePOST /operations/checkimagePerforms checks on a image
createOperationPOST /operations/createCreate new operation and insert it to the database
deleteOperationDELETE /operations/uuid/Delete operation from the database by uuid
deleteOperationsDELETE /operationsDelete operations from the database by UUIDs'
getLogGET /operationsGet log of operations by custom filter
getLogCountGET /operations/countCount operations by filter
getOperationByIdGET /operations/id/Get operation's information by id
getOperationByUUIDGET /operations/uuid/Get operation by UUID
remoteVerifyPOST /operations/remote-verifyRemoteVerify is used to remotely verify a FVTemplate and an encrypted template created locally using MegaMatcherId SDK

checkImage​

Operation checkImage(ChecksFromImage)

Performs checks on a image

Parameters​

NameTypeDescriptionNotes
ChecksFromImageChecksFromImage

Return type​

Operation

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json, /

createOperation​

Integer createOperation(CreateOperationRequest)

Create new operation and insert it to the database

Parameters​

NameTypeDescriptionNotes
CreateOperationRequestCreateOperationRequest

Return type​

Integer

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json, /

deleteOperation​

deleteOperation(uuid)

Delete operation from the database by uuid

Parameters​

NameTypeDescriptionNotes
uuidStringOperation's UUID (from the DB) to be deleted[default to null]

Return type​

null (empty response body)

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /

deleteOperations​

Integer deleteOperations(uuids)

Delete operations from the database by UUIDs'

Parameters​

NameTypeDescriptionNotes
uuidsListList of operation uuids' (from the DB) to be deleted[default to null]

Return type​

Integer

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getLog​

List getLog(page, size, operationsFieldToOrderBy, fieldsOrder, operationTypes, statuses, livenessModes, icaoWarnings, uuid, dateLowerBound, dateUpperBound, yawLowerBound, yawUpperBound, rollLowerBound, rollUpperBound, pitchLowerBound, pitchUpperBound, livenessScoreLowerBound, livenessScoreUpperBound, qualityLowerBound, qualityUpperBound, ageLowerBound, ageUpperBound, matchingScoreLower, matchingScoreUpper, modalities)

Get log of operations by custom filter

Parameters​

NameTypeDescriptionNotes
pageIntegerPage number[optional] [default to 1]
sizeIntegerPage size[optional] [default to 20]
operationsFieldToOrderByStringOperation's field ordered by[optional] [default to OPERATION_DATE] [enum: OPERATION_OPERATION_TYPE, OPERATION_STATUS, OPERATION_LIVENESS_MODE, OPERATION_DATE, OPERATION_UUID, OPERATION_ICAO_WARNING, OPERATION_YAW, OPERATION_ROLL, OPERATION_PITCH, OPERATION_LIVENESS_SCORE, OPERATION_QUALITY, OPERATION_AGE, OPERATION_MODALITY, OPERATION_MATCHING_SCORE, OPERATION_FINGERS_HAND_POSITION, UNRECOGNIZED]
fieldsOrderStringOrder in which is ordered[optional] [default to ASC] [enum: ASC, DESC, UNRECOGNIZED]
operationTypesListTypes of operation[optional] [default to null] [enum: UNSPECIFIED, VERIFY, CHECKS, CREATE_TEMPLATE, REEXTRACT_TEMPLATE, UNRECOGNIZED]
statusesListOperations' statuses[optional] [default to null] [enum: NONE, SUCCESS, TIMEOUT, CANCELED, BAD_QUALITY, MATCH_NOT_FOUND, CAMERA_NOT_FOUND, FACE_NOT_FOUND, LIVENESS_CHECK_FAILED, BAD_SHARPNESS, TOO_NOISY, BAD_LIGHTNING, OCCLUSION, BAD_POSE, TOO_MANY_OBJECTS, MASK_DETECTED, DUPLICATE_FOUND, DUPLICATE_ID, MOTION_BLUR, COMPRESSION_ARTIFACTS, TOO_DISTANT, TOO_CLOSE, FAILED, FINGERS_NOT_FOUND, STATUS_TOO_NORTH, STATUS_TOO_EAST, STATUS_TOO_SOUTH, STATUS_TOO_WEST, MICROPHONE_NOT_FOUND, INITIALIZED, JANUS_UNKNOWN_ERROR, JANUS_PLUGIN_ERROR, JANUS_NOT_FOUND, JANUS_BAD_REQUEST, JANUS_ICE_FAILED, ADJUDICATION_PENDING, AGE_CHECK_FAILED, RESOLUTION_INSUFFICIENT, CHUNK_RECEIVE_TIMEOUT, STREAM_DECODE_FAILED, ADJUSTING_QUALITY, INTERNAL_ERROR, UNRECOGNIZED]
livenessModesListLiveness modes used in operation[optional] [default to null] [enum: DO_NOT_DETECT, PASSIVE, ACTIVE, PASSIVE_AND_ACTIVE, SIMPLE, CUSTOM, PASSIVE_WITH_BLINK, UNRECOGNIZED]
icaoWarningsListICAO warnings[optional] [default to null] [enum: NO_WARNINGS, FACE_NOT_DETECTED, ROLL_LEFT, ROLL_RIGHT, YAW_LEFT, YAW_RIGHT, PITCH_UP, PITCH_DOWN, TOO_NEAR, TOO_FAR, TOO_NORTH, TOO_SOUTH, TOO_EAST, TOO_WEST, SHARPNESS, BACKGROUND_UNIFORMITY, GRAYSCALE_DENSITY, SATURATION, EXPRESSION, DARK_GLASSES, EYES_CLOSED, MOUTH_OPEN, LOOKING_AWAY, RED_EYE, FACE_DARKNESS, UNNATURAL_SKINTONE, WASHED_OUT, PIXELATION, SKIN_REFLECTION, GLASSES_REFLECTION, HEAVY_FRAME, OCCLUSION_WARNING, RESOLUTION_WARNING, MOTION_BLUR_WARNING, COMPRESSION_ARTIFACTS_WARNING, OVEREXPOSURE, UNDEREXPOSURE, GLASSES, HAT, HEAD_MOVEMENT, IMAGE_RESOLUTION, UNRECOGNIZED]
uuidStringOperation's UUID[optional] [default to ]
dateLowerBoundLongDate range that operation was done in unix time (lowerbound)[optional] [default to null]
dateUpperBoundLongDate range that operation was done in unix time (upperbound)[optional] [default to null]
yawLowerBoundDoubleImage's yaw values (lowerbound)[optional] [default to -1.0]
yawUpperBoundDoubleImage's yaw values (upperbound)[optional] [default to -1.0]
rollLowerBoundDoubleImage's roll values (lowerbound)[optional] [default to -1.0]
rollUpperBoundDoubleImage's roll values (upperbound)[optional] [default to -1.0]
pitchLowerBoundDoubleImage's pitch values (lowerbound)[optional] [default to -1.0]
pitchUpperBoundDoubleImage's pitch values (upperbound)[optional] [default to -1.0]
livenessScoreLowerBoundIntegerImage's liveness score (lowerBound)[optional] [default to null]
livenessScoreUpperBoundIntegerImage's liveness score (upperBound)[optional] [default to null]
qualityLowerBoundIntegerImage's quality (lowerBound)[optional] [default to null]
qualityUpperBoundIntegerImage's quality (upperBound)[optional] [default to null]
ageLowerBoundIntegerSubject's determined age (lowerBound)[optional] [default to null]
ageUpperBoundIntegerSubject's determined age (upperBound)[optional] [default to null]
matchingScoreLowerIntegerOperation's verification's matching score (lowerBound)[optional] [default to null]
matchingScoreUpperIntegerOperation's verification's matching score (upperBound)[optional] [default to null]
modalitiesListOperation's modality[optional] [default to null] [enum: FACE_MODALITY, VOICE_MODALITY, FINGERS_MODALITY, UNRECOGNIZED]

Return type​

List

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getLogCount​

Integer getLogCount(operationsFieldToOrderBy, fieldsOrder, operationTypes, statuses, livenessModes, icaoWarnings, uuid, dateLowerBound, dateUpperBound, yawLowerBound, yawUpperBound, rollLowerBound, rollUpperBound, pitchLowerBound, pitchUpperBound, livenessScoreLowerBound, livenessScoreUpperBound, qualityLowerBound, qualityUpperBound, ageLowerBound, ageUpperBound, matchingScoreLower, matchingScoreUpper, modalities)

Count operations by filter

Parameters​

NameTypeDescriptionNotes
operationsFieldToOrderByStringOperation's field ordered by[optional] [default to OPERATION_DATE] [enum: OPERATION_OPERATION_TYPE, OPERATION_STATUS, OPERATION_LIVENESS_MODE, OPERATION_DATE, OPERATION_UUID, OPERATION_ICAO_WARNING, OPERATION_YAW, OPERATION_ROLL, OPERATION_PITCH, OPERATION_LIVENESS_SCORE, OPERATION_QUALITY, OPERATION_AGE, OPERATION_MODALITY, OPERATION_MATCHING_SCORE, OPERATION_FINGERS_HAND_POSITION, UNRECOGNIZED]
fieldsOrderStringOrder in which is ordered[optional] [default to ASC] [enum: ASC, DESC, UNRECOGNIZED]
operationTypesListTypes of operation[optional] [default to null] [enum: UNSPECIFIED, VERIFY, CHECKS, CREATE_TEMPLATE, REEXTRACT_TEMPLATE, UNRECOGNIZED]
statusesListOperations' statuses[optional] [default to null] [enum: NONE, SUCCESS, TIMEOUT, CANCELED, BAD_QUALITY, MATCH_NOT_FOUND, CAMERA_NOT_FOUND, FACE_NOT_FOUND, LIVENESS_CHECK_FAILED, BAD_SHARPNESS, TOO_NOISY, BAD_LIGHTNING, OCCLUSION, BAD_POSE, TOO_MANY_OBJECTS, MASK_DETECTED, DUPLICATE_FOUND, DUPLICATE_ID, MOTION_BLUR, COMPRESSION_ARTIFACTS, TOO_DISTANT, TOO_CLOSE, FAILED, FINGERS_NOT_FOUND, STATUS_TOO_NORTH, STATUS_TOO_EAST, STATUS_TOO_SOUTH, STATUS_TOO_WEST, MICROPHONE_NOT_FOUND, INITIALIZED, JANUS_UNKNOWN_ERROR, JANUS_PLUGIN_ERROR, JANUS_NOT_FOUND, JANUS_BAD_REQUEST, JANUS_ICE_FAILED, ADJUDICATION_PENDING, AGE_CHECK_FAILED, RESOLUTION_INSUFFICIENT, CHUNK_RECEIVE_TIMEOUT, STREAM_DECODE_FAILED, ADJUSTING_QUALITY, INTERNAL_ERROR, UNRECOGNIZED]
livenessModesListLiveness modes used in operation[optional] [default to null] [enum: DO_NOT_DETECT, PASSIVE, ACTIVE, PASSIVE_AND_ACTIVE, SIMPLE, CUSTOM, PASSIVE_WITH_BLINK, UNRECOGNIZED]
icaoWarningsListICAO warnings[optional] [default to null] [enum: NO_WARNINGS, FACE_NOT_DETECTED, ROLL_LEFT, ROLL_RIGHT, YAW_LEFT, YAW_RIGHT, PITCH_UP, PITCH_DOWN, TOO_NEAR, TOO_FAR, TOO_NORTH, TOO_SOUTH, TOO_EAST, TOO_WEST, SHARPNESS, BACKGROUND_UNIFORMITY, GRAYSCALE_DENSITY, SATURATION, EXPRESSION, DARK_GLASSES, EYES_CLOSED, MOUTH_OPEN, LOOKING_AWAY, RED_EYE, FACE_DARKNESS, UNNATURAL_SKINTONE, WASHED_OUT, PIXELATION, SKIN_REFLECTION, GLASSES_REFLECTION, HEAVY_FRAME, OCCLUSION_WARNING, RESOLUTION_WARNING, MOTION_BLUR_WARNING, COMPRESSION_ARTIFACTS_WARNING, OVEREXPOSURE, UNDEREXPOSURE, GLASSES, HAT, HEAD_MOVEMENT, IMAGE_RESOLUTION, UNRECOGNIZED]
uuidStringOperation's UUID[optional] [default to ]
dateLowerBoundLongDate range that operation was done in unix time (lowerbound)[optional] [default to null]
dateUpperBoundLongDate range that operation was done in unix time (upperbound)[optional] [default to null]
yawLowerBoundDoubleImage's yaw values (lowerbound)[optional] [default to -1.0]
yawUpperBoundDoubleImage's yaw values (upperbound)[optional] [default to -1.0]
rollLowerBoundDoubleImage's roll values (lowerbound)[optional] [default to -1.0]
rollUpperBoundDoubleImage's roll values (upperbound)[optional] [default to -1.0]
pitchLowerBoundDoubleImage's pitch values (lowerbound)[optional] [default to -1.0]
pitchUpperBoundDoubleImage's pitch values (upperbound)[optional] [default to -1.0]
livenessScoreLowerBoundIntegerImage's liveness score (lowerBound)[optional] [default to null]
livenessScoreUpperBoundIntegerImage's liveness score (upperBound)[optional] [default to null]
qualityLowerBoundIntegerImage's quality (lowerBound)[optional] [default to null]
qualityUpperBoundIntegerImage's quality (upperBound)[optional] [default to null]
ageLowerBoundIntegerSubject's determined age (lowerBound)[optional] [default to null]
ageUpperBoundIntegerSubject's determined age (upperBound)[optional] [default to null]
matchingScoreLowerIntegerOperation's verification's matching score (lowerBound)[optional] [default to null]
matchingScoreUpperIntegerOperation's verification's matching score (upperBound)[optional] [default to null]
modalitiesListOperation's modality[optional] [default to null] [enum: FACE_MODALITY, VOICE_MODALITY, FINGERS_MODALITY, UNRECOGNIZED]

Return type​

Integer

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getOperationById​

Operation getOperationById(id)

Get operation's information by id

Parameters​

NameTypeDescriptionNotes
idIntegerID to search with. (ID is unique number generated by the DB)[default to null]

Return type​

Operation

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getOperationByUUID​

Operation getOperationByUUID(uuid)

Get operation by UUID

Parameters​

NameTypeDescriptionNotes
uuidStringOperation's UUID[optional] [default to ]

Return type​

Operation

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

remoteVerify​

byte[] remoteVerify(body, subjectId, uuid, modality)

RemoteVerify is used to remotely verify a FVTemplate and an encrypted template created locally using MegaMatcherId SDK

Parameters​

NameTypeDescriptionNotes
bodybyte[]
subjectIdStringSubject id to verify with[optional] [default to null]
uuidStringUUID to verify with[optional] [default to null]
modalityStringModality of template[optional] [default to null] [enum: FACE_MODALITY, VOICE_MODALITY, FINGERS_MODALITY, UNRECOGNIZED]

Return type​

byte[]

Authorization​

user-basic, user-oauth

HTTP request headers​

  • Content-Type: application/octet-stream
  • Accept: application/octet-stream, /