Custom API Action

Evident ID Verify APIまたはSubmit APIに対してカスタムAPI呼び出しを行います。

オプション

入力

出力

Verify APIを呼び出して新しいリクエストを作成する

1. ［API］ドロップダウンメニューで［Verify］を選択します。

2. ［Request Type（リクエストタイプ）］ドロップダウンメニューで［POST］を選択し、［Save（保存）］をクリックします。

3. すべてのリクエスト入力を選択し、［Save（保存）］をクリックします。

4. ［Relative URL（相対URL）］フィールドに/verify/requestsと入力します。

5. ［Body（本文）］フィールドにリクエストを入力します。たとえば、次の入力は運転免許証のデータを要求します。

{
    "description": "Upload license",
    "email": "output@example.com",
    "attributesRequested": 
    [
        {"attributeType": "core.firstname"},
        {"attributeType": "core.lastname"},
        {"attributeType": "core.address.fulladdress"},
        {"attributeType": "identity_assurance.document_verification.americas.us.verification_status"}
    ]
}

APIは、IDが含まれる［Body（本文）］を返します。次のリクエストでそのIDを使用します。

userIdentityTokenを取得する

1. ［API］ドロップダウンメニューで［Verify］を選択します。

2. ［Request Type（リクエストタイプ）］ドロップダウンメニューで［GET］を選択し、［Save（保存）］をクリックします。

3. ［Relative URL（相対URL）］フィールドに/verify/requests/{id}/authTokenに類似する値を入力します。

このステップでユーザーのベアラートークンとリクエストのIDを取得できます。べアラートークンを使用することで、データを送信するためのSubmit APIを呼び出すことができます。

Submit APIを呼び出してデータを送信する

1. ［API］ドロップダウンメニューで［Submit］を選択します。

2. ［Request Type（リクエストタイプ）］ドロップダウンメニューで［POST］を選択し、［Save（保存）］をクリックします。

3. ［Body（本文）］フィールドに入力を追加します。次に例を示します。

{
    "Request:": 
    {
        "Relative URL": "/requests",
        "metadata": "getHttpInputs",
        "config": "",
        "Headers": 
        {
            "Accept": "application/json",
            "Content-Type": "application/json",
            "Authorization": "Bearer <bearer token obfuscated>"
        },
        "Body": 
        {
            "inputs": 
            [
                    {
                        "type": "core.firstname",
                        "value": "Workflows"
                    },
                    {
                        "type": "core.lastname",
                        "value": "Test"
                    },
                    {
                        "type": "certifications.servsafe.servsafe_food_handler.certnumber",
                        "value": "1234567"
                    }
                ]
                }
            }
}

［Relative URL（相対URL）］および［Headers（ヘッダー）］フィールドの値に注意してください。

Submit APIでは、以前のステップで取得したユーザーのベアラートークンを使ってデータを送信できます。

関連項目

Evident IDコネクター

Workflows要素

Evident ID APIのドキュメント