当マニュアルは現在ご利用いただけません。公開までお待ちください。
改訂履歴
概要
1:N顔認証のために、顔写真を含む認証用データ(以下「認証用データ」)を保存するDBが最大20個まで作成できます。各DBに最大50,000人分の認証用データ情報が保存できます。つまり、Nの最大値は100万人となっています。
返却値
HTTP返却値:
システム返却値
01-1:1の比較
アップロードされた2枚の写真を比較し、類似度を返却します。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/face/verify
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": {
"score": 1.0
},
"requestId": "6dcabe1b-6b08-447f-bea1-d18429e10ebc"
}
}
02-認証用データを保存するDBの作成
認証用データを保存するDBを作成します。最大20件のデータまで作成できます。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/create
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": "e5fdc03c-b2c2-45b0-9b42-4c6b3f614000",
"requestId": "797b5476-a88f-4cdb-b3a5-451bf6da7862"
}
}
03-認証用データを保存するDBの削除
認証用データを保存するDBを削除します。
注意事項:認証用データのDBが削除されることによって、DBに保存されるデータも自動的に削除されます。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/delete
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": [
{
"code": 80000,
"message": "OK",
"result": null,
"request_id": "d23ccf7d-ccd7-4228-b420-61bef231a220"
},
{
"code": 80000,
"message": "OK",
"result": null,
"request_id": "d23ccf7d-ccd7-4228-b420-61bef231a220"
}
]
}
04-認証用データを保存するDB一覧の取得
認証用データを保存するDB一覧を取得します。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/list
リクエストパラメータ
なし
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": {
"dbCount": 98,
"dbinfos": [
{
"faceCount": "0",
"id": "35040d1e-c7b9-43d9-93c8-32d301657000",
"name": "senseradar_alert",
"desc": ""
},
{
"faceCount": "0",
"id": "404c159a-118e-4e8b-bed6-d3fab2a33000",
"name": "test2",
"desc": "none"
}
]
},
"requestId": "ad2f6b05-1e5f-4768-b030-1809b6e5430a"
}
}
05-認証用データを保存するDBの更新
認証用データを保存するDBを更新します。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/update
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": {
"dbId": "0d873e4a-c232-4698-902e-5573457d1000",
"name": "liuchang",
"description": "liuchang_test1"
},
"requestId": "74e2225e-8283-4c74-ac47-1e8748ce992b"
}
}
06-認証用データの追加
DBに認証用データを追加します。各DBは最大5万人分の認証用データまで登録できます。
登録する写真は下記の条件に満たす必要があります:
フォマット:JPG(JPEG),BMP,PNG,GIF,TIFF
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/face/add
リクエストパラメータ
{
"dbId": "xxx",
"faces": [{
"face_name": "XXX1",
"image": "XXX",
"threshold": 0.1,
"face_desc": "XXX"
},
{
"face_name": "XXX1",
"image": "XXX",
"threshold": 0.1,
"face_desc": "XXX"
}
]
}
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": [
{
"code": 0,
"message": "",
"faceId": "0d873e4ac2324698902e5573457d10010000000000005b5c"
},
{
"code": 0,
"message": "",
"faceId": "0d873e4ac2324698902e5573457d10010000000000005b5d"
}
],
"requestId": "68482793-d3c2-4086-abd2-11b81fc3c728"
}
}
07-認証用データの削除
DBから特定の認証用データを削除します。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/face/delete
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80005,
"message": "NOT_FOUND",
"result": null,
"requestId": "179bd42c-4612-4343-aecf-eec764935cf6"
}
}
08-認証用データの取得
認証用データを取得します。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/face/info
リクエストパラメータ
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": {
"response": {
"code": 0,
"message": "",
"dbId": "0d873e4a-c232-4698-902e-5573457d1000",
"faceId": "0d873e4ac2324698902e5573457d10010000000000005aee",
"faceName": "test-mercury-api",
"faceDesc": "nothing"
}
},
"requestId": "a27b09b4-9b8c-43ac-a186-c63131926c25"
}
}
09-類似する認証用データの検索
対象の認証用データ(写真)を元に、DBから最も類似するTop Kのを検用索します。検索結果は、類似度の高い順に並べ替えられます。
リクエスト方法
POST Content-Type: application/json
リクエストアドレス
http://ip:port/api/v3/db/face/search
リクエストパラメータ
注意事項:閾値は空ではない場合、閾値より大きな類似度の結果のみ返却します。例えば、条件に満たす結果の数はNの時、N=0なら、空の返却となります;N<top_kなら、全ての結果を返却します;N>=top_kなら、top_kの結果のみ返却します。
レスポンス結果
{
"code": 200,
"message": "OK",
"desc": null,
"data": {
"code": 80000,
"message": "OK",
"result": {
"response": [
{
"code": 5,
"message": "rpc error: code = NotFound desc = db not found",
"dbId": "",
"similarResults": []
},
{
"code": 0,
"message": "",
"dbId": "0d873e4a-c232-4698-902e-5573457d1000",
"similarResults": [
{
"faceId": "0d873e4ac2324698902e5573457d10010000000000005aee",
"score": 1.0
}
]
}
]
},
"requestId": "c88c6027-907e-4f69-8dc8-c750f6372d1f"
}
}