カスタムAPIアクション
Evident ID Verify APIまたはSubmit APIに対してカスタムAPI呼び出しを行います。
このカードがサポートするのは本稼働APIのみです。サンドボックスAPI（デモAPIとも呼ばれます）はサポートされません。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
API |
クエリする適切なAPI（ |
ドロップダウン | 正 |
|
リクエストタイプ（Request Type） |
これはカスタムAPI呼び出しでサポートされる以下のいずれかのHTTPリクエストメソッド、つまりHTTP動詞です（「HTTPリクエストメソッド」を参照）。
|
ドロップダウン | 正 |
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
ユーザー（User） |
|||
|
相対URL（Relative URL） |
呼び出すWebサーバーのURLアドレス。
たとえば、Evident ID APIエンドポイントの場合：
Evident IDAPIのドキュメントを参照してください。 |
テキスト | 正 |
|
クエリ（Query） |
キー/値のペアとして含める必要がある追加のクエリパラメーターを指定します。 例： |
オブジェクト | FALSE |
|
ヘッダー（Headers） |
|
オブジェクト | FALSE |
|
本文（Body） |
リクエスト本文をJSON形式で指定します。 この入力は、 |
オブジェクト | FALSE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
レスポンス（Response ） |
||
|
ステータスコード（Status Code） |
操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例：
発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。 |
数値 |
|
ヘッダー（Headers） |
出力ボディーとは関係のない、ステータスコードの詳細なコンテキスト。レスポンスヘッダーは、選択したHTTPリクエストオプションによって決定します。すべてのヘッダーがレスポンスヘッダーというわけではありません。これは、 |
オブジェクト |
|
本文（Body） |
選択したHTTPリクエストから返されたデータ。 たとえば、 |
オブジェクト |
Verify APIを呼び出して新しいリクエストを作成する
-
APIドロップダウンメニューで
Verifyを選択します。 -
リクエストタイプ（Request Type）ドロップダウンメニューで
POSTを選択し、保存（Save）をクリックします。 -
すべてのリクエスト入力を選択し、保存（Save）をクリックします。
-
相対URL（Relative URL）フィールドに
/verify/requestsと入力します。 -
本文（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を取得する
-
APIドロップダウンメニューで
Verifyを選択します。 -
リクエストタイプ（Request Type）ドロップダウンメニューで
GETを選択し、保存（Save）をクリックします。 -
相対URL（Relative URL）フィールドに
/verify/requests/{id}/authTokenに類似する値を入力します。
このステップでユーザーのベアラートークンとリクエストのIDを取得できます。べアラートークンを使用することで、データを送信するためのSubmit APIを呼び出すことができます。
Submit APIを呼び出してデータを送信する
-
APIドロップダウンメニューで
Submitを選択します。 -
リクエストタイプ（Request Type）ドロップダウンメニューで
POSTを選択し、保存（Save）をクリックします。 -
本文（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"
}
]
}
}
}相対URL（Relative URL）およびヘッダー（Headers）フィールドの値に注意してください。
Submit APIでは、以前のステップで取得したユーザーのベアラートークンを使ってデータを送信できます。