1.1 /identity/image_verification/stateless

インターフェースを介してアップロードされた2つの顔写真を比較して、2つの顔が同一人物のものかどうかを判断します。

写真の規格は、運用マニュアルの3章 写真と動画の規格をご参照ください。

リクエストモード

POST

リクエスト URL

http://ip:port/identity/image_verification/stateless

リクエストパラメーター

フィールド	型	必須	説明
first_encrypted_image	string	Yes	暗号化された写真1。暗号化方法の参照: 個人データの暗号化
second_encrypted_image	string	Yes	暗号化された写真2。暗号化方法の参照: 個人データの暗号化
auto_rotate	boolean	No	デフォルト値はfalseで、写真が回転していないことを示します。値がtrueの場合、写真は自動的に回転されます
check_quality	boolean	No	デフォルト値はfalseで、画質テストは行われません。値がtrueの場合、画質のテストが行われます

通常のレスポンス

フィールド	型	説明
code	int	システムレスポンスコード：1000
verification_score	float	顔比較スコア、範囲：0〜1 。値が大きいほど、2つの顔が同じ人物のものである確率が高くなります
request_id	string	リクエストのID

{
    "code": 1000,
    "verification_score": float,
    "request_id": string
}

顔比較スコアのしきい値とエラー率との対応関係

閾値	0.4	0.5	0.6	0.7	0.8	0.9
エラー率	1/10	1/100	1/1000	1/10,000	1/100,000	1/1,000,000

推奨しきい値：0.7以上

異常なレスポンス

フィールド	型	説明
code	int	システムレスポンスコード
message	string	エラーメッセージ
request_id	string	リクエストのID

{
    "code": int,
    "message": string,
    "request_id": string
}

システムレスポンスコードの説明

コード	フィールドの値	説明
1200	invalid argument	無効な入力パラメーター
2003	invalid image size	写真サイズ（幅と高さのピクセル数）が要件を満たしていません
2004	invalid content length	写真のファイルサイズが要件を満たしていません
2005	invalid image type or corrupted	写真タイプが要件を満たしていません
4000	detection failed	特徴の抽出に失敗しました。写真に顔が検出されませんでした
4004	face occlusion	顔は検出されていますが、目、鼻、口で部分的に見えなくなっています

可能なHTTPステータスコード

ステータスコード	ステータスフィールド
400	BAD_REQUEST
404	NOT_FOUND
411	LENGTH_REQUIRED
413	PAYLOAD_TOO_LARGE
500	INTERNAL_ERROR

使用サンプル

Curl

curl -X POST "http://ip:port/identity/image_verification/stateless" \
  -d first_encrypted_image=xxx \
  -d second_encrypted_image=xxx \
  -d auto_rotate=true

Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpEntity;
import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

public class HttpClient {
    public static final String POST_URL = "http://127.0.0.1:3000/identity/image_verification/stateless";
    private static AESCipher cipher = new AESCipher("dcbbad6765e14139a07d34b92292a672", "df25d188a061");

    public static void Post() throws Exception {
        CloseableHttpClient httpclient = HttpClients.createDefault();
        HttpPost post = new HttpPost(POST_URL);

        List<NameValuePair> params = new ArrayList<>();

        String firstEncryptedImage = cipher.encrypt(
                Files.readAllBytes(Paths.get("src/main/resources/face_01.jpg")));
        String secondEncryptedImage = cipher.encrypt(
                Files.readAllBytes(Paths.get("src/main/resources/face_02.jpg")));

        params.add(new BasicNameValuePair("first_encrypted_image", firstEncryptedImage));
        params.add(new BasicNameValuePair("second_encrypted_image", secondEncryptedImage));

        post.setEntity(new UrlEncodedFormEntity(params));
        HttpResponse response = httpclient.execute(post);

        if (response.getStatusLine().getStatusCode() == 200) {
            HttpEntity respEntity = response.getEntity();
            BufferedReader reader = new BufferedReader(new InputStreamReader(respEntity.getContent()));
            String line = reader.readLine();
            System.out.println(line);
        } else {
            HttpEntity respEntity = response.getEntity();
            String responseString = EntityUtils.toString(respEntity);
            System.out.println("error:" + response.getStatusLine().getStatusCode()
                    + "  " + response.getStatusLine().getReasonPhrase());
            System.out.println("cause of error:"+responseString);
        }
    }

    public static void main(String[] args) throws Exception {
        Post();
    }
}