Auth

Poll request status / fetch the result

Readable with the provider's Basic credentials, or with the request's clientToken.

get/auth/{requestId}

Request

  • Base URL: https://atk.tvarka.pro/v1
  • URL: https://atk.tvarka.pro/v1/auth/{requestId}
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

requestIdstring uuid required

The requestId returned by POST /auth/requests.

Response

Current state.

requestIdstring uuid required
method'physical' | 'nfc' required

physical = desktop reader; nfc = phone tap.

status'pending' | 'awaitingCard' | 'awaitingCredentials' | 'finalizing' | 'done' | 'cancelled' | 'timeout' | 'deviceError' | 'pinBlocked' | 'cardRemoved' | 'certInvalid' required

Flat request status. Non-terminal - pending, awaitingCard, awaitingCredentials, finalizing. Terminal success - done. Terminal failure - cancelled/timeout/deviceError/pinBlocked/cardRemoved/certInvalid. awaitingCredentials is SDK-reported (CAN/PIN entry is out-of-band).

noncestring

Server-minted challenge nonce (see Challenge) - enables independent sig verification from polling alone.

sigstring byte
assertionstring

Example response

{
  "method": "physical",
  "cert": {
    "subject": {
      "serialNumber": "PNOLT-39001010000",
      "c": "LT"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.