1 / 1

Mercury APIマニュアル - Beta

当マニュアルは現在ご利用いただけません。公開までお待ちください。

改訂履歴

概要

1：N顔認証のために、顔写真を含む認証用データ（以下「認証用データ」）を保存するDBが最大20個まで作成できます。各DBに最大50,000人分の認証用データ情報が保存できます。つまり、Nの最大値は100万人となっています。

返却値

HTTP返却値：

システム返却値

01-１：１の比較

アップロードされた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
幅と高さの両方は8px以上，4000px以下
写真サイズは5MB以下

リクエスト方法

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"
    }
}

Mercury APIマニュアル - Beta

当マニュアルは現在ご利用いただけません。公開までお待ちください。

改訂履歴

概要

返却値

HTTP返却値：

システム返却値

01-１：１の比較

アップロードされた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
幅と高さの両方は8px以上，4000px以下
写真サイズは5MB以下

リクエスト方法

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

リクエストパラメータ

レスポンス結果

{
    "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"
    }
}