@vkid/sdk

VK ID SDK — это библиотека для безопасной и удобной авторизации пользователей в вашем сервисе через VK ID.

---

ℹ️ Версия VK ID SDK 2.3.0 поддерживает авторизацию по протоколу OAuth 2.1, а также способы входа через аккаунты Одноклассников и Mail.

---

Установка

NPM:

npm i @vkid/sdk@^2.0.0

YARN:

yarn add @vkid/sdk@^2.0.0

PNPM:

pnpm add @vkid/sdk@^2.0.0

CDN:

<script src="https://unpkg.com/@vkid/sdk@<3.0.0/dist-sdk/umd/index.js"></script>

Обратите внимание: Для работы авторизации нужен APP_ID. Вы получите его, когда создадите приложение в кабинете подключения VK ID.

Пример

Базовая авторизация

import * as VKID from '@vkid/sdk';

VKID.Config.init({
  app: APP_ID,
  redirectUrl: 'https://example.com',
  state: 'state',
  codeVerifier: 'codeVerifier',
  scope: 'phone email',
});


const authButton = document.createElement('button');
authButton.onclick = () => {
  // После авторизации будет редирект на адрес, указанный в параметре redirectUrl
  VKID.Auth.login()
    .catch(console.error);
};

document.getElementById('container').appendChild(authButton);

OneTap

import * as VKID from '@vkid/sdk';

VKID.Config.init({
  app: APP_ID,
  redirectUrl: 'https://example.com',
  state: 'state',
  codeVerifier: 'codeVerifier',
  scope: 'phone email',
});

const oneTap = new VKID.OneTap();

const container = document.getElementById('VkIdSdkOneTap');

if (container) {
  oneTap
    .render({ container })
    .on(VKID.WidgetEvents.ERROR, console.error);
}

Документация

• Что такое VK ID
• Создание приложения
• Требования к дизайну
• Спецификация

Contributing

Проект VK ID SDK имеет открытый исходный код на GitHub, и вы можете присоединиться к его доработке — мы будем благодарны за внесение улучшений и исправление возможных ошибок.

Code of Conduct

Если вы собираетесь вносить изменения в проект VK ID SDK, следуйте правилам разработки. Они помогут понять, какие действия возможны, а какие недопустимы.

Contributing Guide

В руководстве вы можете подробно ознакомиться с процессом разработки и узнать, как предлагать улучшения и исправления, а ещё — как добавлять и тестировать свои изменения в VK ID SDK. Также рекомендуем ознакомиться с общими правилами оформления кода в проекте.

Changelog

2.4.0 (22-10-2024)

Added

• [VK ID SDK] Для новых пользователей сервиса авторизации добавили возможность подключения аналитики MyTracker. С ней вы сможете изучать аналитику данных по пользователям, которые выполнили вход в приложение через VK ID: получать наглядные отчёты, анализировать поведение аудитории и оптимизировать свои маркетинговые стратегии.

Fixed

• [VK ID SDK] Исправлено написание буквы с в тексте «Войти с VK ID» кнопки One Tap: теперь используется буква русского алфавита, а не латинского.