diff --git a/index.html b/index.html index 59cc7cf..6a97ecc 100644 --- a/index.html +++ b/index.html @@ -2216,13 +2216,13 @@
Request Body schema: application/json
tag
string

Session identificator.

Array of objects

Array of Person images.

object

If a person is not found, a new person entry is created using the descriptor calculated while searching.

-
groupIds
Array of integers

IDs of the groups in which the search is performed.

+
groupIds
Array of strings <uuid>

IDs of the groups in which the search is performed.

Responses

Response Schema: application/json
code
required
integer (FaceSDKResultCode)
Enum: 0 1 2 3 4 … 34 more
Array of objects (MatchImageResult)
elapsedTime
float
object

A free-form object containing person's extended attributes.

Array of objects

Request samples

Content type
application/json
{
  • "tag": "string",
  • "images": [
    • {
      • "content": "string",
      • "type": 1
      }
    ],
  • "createPerson": {
    • "name": "string",
    • "metadata": { }
    },
  • "groupIds": [
    • 0
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "results": [
    • {
      • "firstIndex": 0,
      • "firstFaceIndex": 0,
      • "first": 1,
      • "secondIndex": 0,
      • "secondFaceIndex": 0,
      • "second": 1,
      • "score": 0,
      • "similarity": 0
      }
    ],
  • "elapsedTime": 1.317137987,
  • "metadata": { },
  • "detections": [
    • {
      • "faces": [
        • {
          • "faceIndex": 0,
          • "landmarks": [
            ],
          • "rotationAngle": 2.1272900104522705,
          • "roi": [
            ],
          • "thumbnail": "string",
          • "persons": [
            ]
          }
        ],
      • "imageIndex": 0,
      • "status": 0
      }
    ]
}

Detect face, evaluate attributes, assess the portrait quality

header Parameters
X-RequestID
string

Request header label.

+
http://localhost:41101/api/match_and_search

Request samples

Content type
application/json
{
  • "tag": "string",
  • "images": [
    • {
      • "content": "string",
      • "type": 1
      }
    ],
  • "createPerson": {
    • "name": "string",
    • "metadata": { }
    },
  • "groupIds": [
    • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "results": [
    • {
      • "firstIndex": 0,
      • "firstFaceIndex": 0,
      • "first": 1,
      • "secondIndex": 0,
      • "secondFaceIndex": 0,
      • "second": 1,
      • "score": 0,
      • "similarity": 0
      }
    ],
  • "elapsedTime": 1.317137987,
  • "metadata": { },
  • "detections": [
    • {
      • "faces": [
        • {
          • "faceIndex": 0,
          • "landmarks": [
            ],
          • "rotationAngle": 2.1272900104522705,
          • "roi": [
            ],
          • "thumbnail": "string",
          • "persons": [
            ]
          }
        ],
      • "imageIndex": 0,
      • "status": 0
      }
    ]
}

Detect face, evaluate attributes, assess the portrait quality

header Parameters
X-RequestID
string

Request header label.

Request Body schema: application/json
tag
string

Session identificator.

object (ProcessParam)

The processing parameters.

image
string <byte> (ImageData)

Base64 encoded image.

@@ -2484,7 +2484,7 @@

Request samples

Content type
application/json
{
  • "addItems": [
    • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
  • "removeItems": [
    • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}

Response samples

Content type
application/json
{
  • "statusCode": 0,
  • "type": "string",
  • "msg": "string"
}

search

Find person by image in groups

header Parameters
X-RequestID
string

Request header label.

Request Body schema: application/json
object

If a person is not found, a new person entry is created using the descriptor calculated while searching.

-
groupIds
Array of integers

IDs of the groups in which the search is performed.

+
groupIds
Array of strings <uuid>

IDs of the groups in which the search is performed.

tag
string

Session identificator.

object

Uploaded image.

object (OutputImageParams)

Whether to process the uploaded image according to the indicated settings.

@@ -2500,7 +2500,7 @@
object

A free-form object containing person's extended attributes.

Response Schema: application/json
msg
string
Default: "Descriptor already calculated"
statusCode
integer
Default: 400
type
string
Default: "BadParamsException"

Request samples

Content type
application/json
{
  • "createPerson": {
    • "name": "string",
    • "metadata": { }
    },
  • "groupIds": [
    • 0
    ],
  • "tag": "string",
  • "image": {
    • "contentType": "string",
    • "content": "string",
    • "imageUrl": "string",
    • "resizeOptions": {
      • "width": 0,
      • "height": 0,
      • "quality": 100
      }
    },
  • "outputImageParams": {
    • "backgroundColor": [
      • 128,
      • 128,
      • 128
      ],
    • "crop": {
      • "type": 0,
      • "padColor": [
        • 128,
        • 128,
        • 128
        ],
      • "size": [
        • 300,
        • 400
        ],
      • "returnOriginalRect": true
      }
    },
  • "detectAll": false,
  • "threshold": null,
  • "limit": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "persons": [
    • {
      • "tag": "string",
      • "name": "string",
      • "metadata": { },
      • "groups": [
        • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
      • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      • "createdAt": "string",
      • "updatedAt": "string",
      • "detection": {
        • "code": 0,
        • "crop": "string",
        • "detectorType": 0,
        • "hash": "string",
        • "idx": 0,
        • "image": "string",
        • "landmarks": [
          • [
            ]
          ],
        • "landmarksType": 2,
        • "msg": "string",
        • "roi": [
          • "x",
          • "y",
          • "width",
          • "height"
          ],
        • "versionSDK": "5.2.245.687"
        },
      • "images": [
        • {
          • "id": "string",
          • "contentType": "string",
          • "createdAt": "string",
          • "updatedAt": "string",
          • "path": "string",
          • "url": "string",
          • "metadata": { },
          • "similarity": 0,
          • "distance": 0
          }
        ]
      }
    ]
}

liveness 2.0

Liveness assessment

query Parameters
transactionId
required
string <uuid>

ID of the current liveness transaction.

+
http://localhost:41101/api/search

Request samples

Content type
application/json
{
  • "createPerson": {
    • "name": "string",
    • "metadata": { }
    },
  • "groupIds": [
    • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
  • "tag": "string",
  • "image": {
    • "contentType": "string",
    • "content": "string",
    • "imageUrl": "string",
    • "resizeOptions": {
      • "width": 0,
      • "height": 0,
      • "quality": 100
      }
    },
  • "outputImageParams": {
    • "backgroundColor": [
      • 128,
      • 128,
      • 128
      ],
    • "crop": {
      • "type": 0,
      • "padColor": [
        • 128,
        • 128,
        • 128
        ],
      • "size": [
        • 300,
        • 400
        ],
      • "returnOriginalRect": true
      }
    },
  • "detectAll": false,
  • "threshold": null,
  • "limit": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "persons": [
    • {
      • "tag": "string",
      • "name": "string",
      • "metadata": { },
      • "groups": [
        • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
      • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      • "createdAt": "string",
      • "updatedAt": "string",
      • "detection": {
        • "code": 0,
        • "crop": "string",
        • "detectorType": 0,
        • "hash": "string",
        • "idx": 0,
        • "image": "string",
        • "landmarks": [
          • [
            ]
          ],
        • "landmarksType": 2,
        • "msg": "string",
        • "roi": [
          • "x",
          • "y",
          • "width",
          • "height"
          ],
        • "versionSDK": "5.2.245.687"
        },
      • "images": [
        • {
          • "id": "string",
          • "contentType": "string",
          • "createdAt": "string",
          • "updatedAt": "string",
          • "path": "string",
          • "url": "string",
          • "metadata": { },
          • "similarity": 0,
          • "distance": 0
          }
        ]
      }
    ]
}

liveness 2.0

Liveness assessment

query Parameters
transactionId
required
string <uuid>

ID of the current liveness transaction.

Responses

Response Schema: application/json
code
integer

Result code, one of the FaceSDKResultCode enum values. See the enum: https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-sdk-result-code/

status
integer
Default: null

Whether the liveness detection is confirmed (0) or not (1).

tag
string

Session identificator.

@@ -2516,7 +2516,7 @@
Response Schema: application/json
property name*
additional property
any

Response samples

Content type
application/json
{ }