VK Direct

Poll Login

Poll VK QR scan status.

Should be called by the frontend every few seconds until:

  • status authenticated → done, gateway restarted
  • status need_refresh_qr → QR session is unrecoverable, call /init again. Covers: QR expired (server-side error 1112), VK QR session timeout (status 4), user cancelled in the mobile app (status 3).
  • status need_validation_code → VK flagged the login as suspicious; collect the validation code from the user and re-call /login with validation_code set (keep polling normally afterwards)
post/companies/{company_id}/vk_direct/login

Request

  • Base URL: https://api.radist.online/v2
  • URL: https://api.radist.online/v2/companies/{company_id}/vk_direct/login
  • Auth: one of:
    • API key in header X-Api-Key
    • OAuth 2 (password, token URL https://auth.radist.online/auth/realms/radist/protocol/openid-connect/token)

Path parameters

company_idinteger required

Request body

session_idstring required
validation_codestring nullable

Response

Successful Response

session_idstring required
status'authenticated' | 'waiting_for_qr_scan' | 'need_refresh_qr' | 'need_validation_code' required

Changes

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