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, 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, INITIALIZED, JANUS_UNKNOWN_ERROR, JANUS_PLUGIN_ERROR, JANUS_NOT_FOUND, JANUS_BAD_REQUEST, JANUS_ICE_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_LEFT_HAND_MODALITY, FINGERS_RIGHT_HAND_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, 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, INITIALIZED, JANUS_UNKNOWN_ERROR, JANUS_PLUGIN_ERROR, JANUS_NOT_FOUND, JANUS_BAD_REQUEST, JANUS_ICE_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_LEFT_HAND_MODALITY, FINGERS_RIGHT_HAND_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_LEFT_HAND_MODALITY, FINGERS_RIGHT_HAND_MODALITY, UNRECOGNIZED]

Return type

byte[]

Authorization

user-basic, user-oauth

HTTP request headers

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