{ "opencollection": "1.0.0", "info": { "name": "Tvarka Atk Pairing API", "version": "1.3.0" }, "request": { "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "items": [ { "info": { "name": "Pairing", "type": "folder" }, "items": [ { "info": { "name": "Get a pairing token/QR to complete this request on a phone", "type": "http" }, "http": { "method": "GET", "url": "https://atk.tvarka.pro/v1/auth/:requestId/pairing", "params": [ { "name": "requestId", "value": "", "type": "path", "description": "The `requestId` returned by `POST /auth/requests`." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Only for `method:\"nfc\"`. Basic only - the integrator's server rotates the one-time token.\nReturns a high-entropy, short-lived, one-claim pairing token and a deep link / QR the phone\nscans. The phone then calls `/pairing/claim`, receives the request's `clientToken`, and\ndrives the same `/certificate` + `/complete` endpoints.\n" }, { "info": { "name": "Claim a pairing token from the tapping phone", "type": "http" }, "http": { "method": "POST", "url": "https://atk.tvarka.pro/v1/pairing/claim", "body": { "type": "json", "data": "{}" } }, "docs": "No Basic auth - authorized solely by the high-entropy `pairingToken`. One-claim, rate-limited,\nstored hashed. Returns the request's `clientToken` and a minimal `summary` (purpose + label\nonly, never document contents).\n" } ] } ], "bundled": true }