Custom API Action（カスタムAPIアクション）

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

オプション

入力

出力

新規リクエストを作成するためのVerify APIの呼び出し

1. [API (API)]ドロップダウンで、[Verify (Verify)]を選択します。

2. [Request Type (リクエストタイプ)]ドロップダウンで、[POST (POST)]を選択し、[Save (保存)]をクリックします。

3. すべてのリクエスト入力を選択し、[Save (保存)]をクリックします。

4. [Relative URL (相対URL)]フィールドに、/verify/requestsと入力します。

5. [Body (ボディー)]フィールドにリクエストを入力します。たとえば、次の入力は運転免許証のデータを要求します。

1
2
3
4
5
6
7
8
9
10
11
{
    "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が含まれる本文を返します。次のリクエストでそのidを使用します。

userIdentityTokenの取得

1. [API (API)]ドロップダウンで、[Verify (Verify)]を選択します。

2. [Request Type (リクエストタイプ)]ドロップダウンで、[GET (GET)]を選択し、[Save (保存)]をクリックします。

3. [Relative URL (相対URL)]フィールドに、/verify/requests/{id}/authTokenと同様のデータを入力します。

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

データを送信するためのSubmit APIの呼び出し

1. [API (API)]ドロップダウンで、[Submit (Submit)]を選択します。

2. [Request Type (リクエストタイプ)]ドロップダウンで、[POST (POST)]を選択し、[Save (保存)]をクリックします。

3. [Body (Body)]フィールドに入力を追加します。次に例を示します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
    "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のドキュメント