"Familiar face"-"stranger" face search API

The body of POST request must contain the image of searched face in base64 format:

{
 "image": "base64 encoded image"
}

The request itself can be represented in two ways:

  1. POST http://IP-Address:port/prefix/faceAppearanceRate/{DETECTORID}/{BEGINTIME}/{ENDTIME}

    • DETECTORID – endpoint detection tool ternary ID (HOSTNAME/AVDetector.ID/EventSupplier for auto and face search, HOSTNAME/AVDetector.ID/SourceEndpoint.vmda for vmda, see Get a list of detectors of a camera).
    • The ENDTIME and BEGINTIME syntax is described in Get archive contents section.


  2. POST http://IP-Address:port/prefix/faceAppearanceRate/{HOSTNAME}/{BEGINTIME}/{ENDTIME}

    HOSTNAME – Server name.


ParameterRequiredDescription
accuracyNoDetection accuracy in the range [0,1] (1 means complete match). If this parameter is not set, then the default value (0.9) is in use.

Sample request:

POST http://127.0.0.1:80/faceAppearanceRate/SERVER1/AVDetector.2/EventSupplier/past/future?accuracy=0.7

Sample response:

{
  "rate": 0.13333334028720856
}


ParameterDescription
rateRate of identifying a face as a “stranger”, the value in the [0,1] range. 1 means a complete stranger.