Pairing

Claim a pairing token from the tapping phone

No Basic auth - authorized solely by the high-entropy pairingToken. One-claim, rate-limited, stored hashed. Returns the request's clientToken and a minimal summary (purpose + label only, never document contents).

post/pairing/claim

Request

  • Base URL: https://atk.tvarka.pro/v1
  • URL: https://atk.tvarka.pro/v1/pairing/claim
  • Auth: none required

Request body

pairingTokenstring required
claimNoncestring

Optional; when the originating UI can pre-share it, binds the tap to the intended session.

Response

Claimed.

requestIdstring uuid required
purpose'auth' | 'sign' required
clientTokenstring required
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).

summaryobject

Minimal display context {purpose, provider, audience, label, format?} - never document contents.

Changes

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