Docs
Status
Supportk-id.comCompliance Studio
Endpoints위젯

위젯 상태 일괄 조회

한 번의 요청으로 여러 엔드투엔드 또는 연령 게이트 위젯의 상태를 반환합니다. 최대 100개의 위젯 ID를 받아 위젯 ID를 키로 하는 객체를 반환합니다. 각 값은 위젯 상태이거나, 위젯을 찾을 수 없는 경우 `ClientErrorResponse`입니다.

POST
/widget/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/widget/get-status" \  -H "Content-Type: application/json" \  -d '{    "widgetIds": [      "2f6c1d3e-8a4b-4c5d-9e6f-7a8b9c0d1e2f",      "0bb4a2c1-3d5e-4f6a-8b7c-9d0e1f2a3b4c"    ]  }'
{  "2f6c1d3e-8a4b-4c5d-9e6f-7a8b9c0d1e2f": {    "widgetId": "2f6c1d3e-8a4b-4c5d-9e6f-7a8b9c0d1e2f",    "status": "PASS",    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672"  },  "0bb4a2c1-3d5e-4f6a-8b7c-9d0e1f2a3b4c": {    "error": "NOT_FOUND",    "errorMessage": "Widget not found"  }}

위젯 상태 가져오기 GET

`/widget/generate-e2e-url` 또는 `/widget/generate-age-gate-url`이 반환한 `widgetId`를 키로 하여 엔드투엔드 또는 연령 게이트 위젯 흐름의 결과를 반환합니다. 위젯의 QR 코드를 스캔한 휴대폰 등 플레이어가 다른 기기에서 흐름을 완료하고 자체 서비스에서 그 결과가 필요할 때 사용하십시오. 위젯이 한 번 `PASS`를 보고하면 이후에도 계속 `PASS`를 보고합니다. 이어서 `/session/get`을 호출하여 세션의 현재 상태와 권한을 조회하십시오. 결과를 신속하게 알아야 한다면 자주 폴링하는 대신 웹훅을 구독하십시오.