Docs
Status
Supportk-id.comCompliance Studio
Endpointsチャレンジ

チャレンジのステータスを一括取得する

1回のリクエストで複数のチャレンジのステータスを返します。 最大100件のチャレンジIDを受け付け、チャレンジIDをキーとするオブジェクトを返します。各値はチャレンジのステータス、またはチャレンジを取得できなかった場合は `ClientErrorResponse` になります。

POST
/challenge/get-status

Authorization

api-key
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/challenge/get-status" \  -H "Content-Type: application/json" \  -d '{    "challengeIds": [      "ae6d4729-af32-42ea-8ef2-ff46c7664802",      "f47ac10b-58cc-4372-a567-0e02b2c3d479"    ]  }'

{  "ae6d4729-af32-42ea-8ef2-ff46c7664802": {    "status": "PASS",    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",    "approverEmail": "user@example.com"  },  "f47ac10b-58cc-4372-a567-0e02b2c3d479": {    "status": "IN_PROGRESS"  }}

チャレンジステータスを取得する GET

チャレンジの結果を返します。保護者の操作を待つ間にポーリングするエンドポイントです。 `/age-gate/check` が `CHALLENGE` を返した後に呼び出してください。`PASS` が返されたら、続いて `/session/get` を呼び出し、`ACTIVE` になったセッションとその権限を取得します。`FAIL` はチャレンジが確定し、これ以上進行しないことを意味します。

チャレンジを取得する GET

既存のチャレンジを返します。 チャレンジが成功または失敗した後は `oneTimePassword` と `url` は含まれません。再提示する必要がある場合は、チャレンジが有効な間に取得しておいてください。