@time-is-money/frontend-module
v1.0.4
Published
Plugin for integration with TiM app.
Downloads
6
Maintainers
stolentineReadme
Time is Money
Наш сайт.
Этот модуль необходим для получения данных из приложения ТиМ, установленного на смартфоне пользователя. Все, что вам нужно - это указать необходимые документы, а плагин возьмет все взаимодействие на себя.
Установка
Доступно несколько вариантов установки:
npm
Выполните команду в терминале:
npm i @time-is-money/frontend-moduleПеред использованием дождитесь загрузки модуля, внутри обработчика кнопки вызова плагина.
import {loader} from "@time-is-money/frontend-module"
const clickTimButtonHandler = async () => {
const tim = await loader()
// работа с плагином
}CDN
Добавьте скрипт внутри тега <head> на страницe вашего сайта:
<script src="https://frontend-module.time-money.shop/v1/index.js" defer></script>Пример использование
Создайте клиент и передайте в конструктор параметры вашего плагина. Эти параметры можно найти на сайте в личном кабинете.
const timClient = new tim.Client({
id: 0,
secret: "00000000-0000-0000-0000-000000000000",
});Вызовите функцию getDocuments() и передайте необходимый список документов. Актуальный список документов можно посмотреть здесь. Клиент сам отобразит интерфейс ТиМ и выполнит все взаимодействия с пользователем. После завершения вам вернется объект с данными документов или ошибка.
timClient.getDocuments(['passport', "INN"])
.then(data => {
// присваиваем полям значение из ответа
document.getElementById('firstName').value = data?.passport?.first_name
document.getElementById('inn').value = data?.INN?.number
})
.catch(err => {
err && alert(err) // если пользователь закрое окно ТиМ. Вернется err === null
})Пример результата getDocuments(['passport', "INN"])
{
"passport": {
"series": "2385",
"number": "658927",
"last_name": "Летов",
"first_name": "Егор",
"patronymic": "Федорович",
"birth_date": "1964-09-10",
"sex": "Мужской",
"birthplace": "Омск, город Омск, Омская область",
"department_name": "Мвд города Омск",
"issue_date": "1975-06-01",
"department_number": "333-000",
"registration_address": "Омск, улица Ленина, 22"
},
"INN": {
"number": "122356789865004835000"
}
}Внимание! В ответе будут только объекты документов, которые заполнены у пользователя. Это значит, что если
в приложении Tim у пользователя не заполнены, например, паспортные данные, то getDocuments(['passport]) вернет пустой объект.