Прочие методы

createDeeplink

iOS 3.7Android 3.7Web 3.7Backend 3.7

Метод генерации ссылок на SmartApp.

Аргументы

Аргументом метода является объект, содержащий параметры:

Параметр	Тип данных	Описание
appId	string	ID SmartApp, которое откроется. Скопируйте значение в поле App ID (уникальный человекочитаемый идентификатор бота) в консоли администратора CTS
meta	list	Полезные данные запроса, которые получит бот

Возвращаемое значение

Возвращаемое значение содержит Promise, который после исполнения вернет объект с атрибутом payload. Обхект содержит свойство deeplink со сформированной ссылкой.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  const response = await SDK.createDeeplink({
    appId: "email-smartapp",
    meta: [
      {
        key: "route",
        value: "new-mail",
      }, {
        key: "to",
        value: "test@mail.ru",
      }
    ],
  });

  if (response?.status == "success") {
    console.log("Here your deeplink = ", response.data.deeplink);
  }
}

requestLocation

iOS 3.3Android 3.3Web 3.3

Метод получения текущего местоположения. Применим только на мобильных устройствах.

Возвращаемое значение

Возвращаемое значение содержит Promise, который после исполнения вернет объект с атрибутом payload, содержащим свойства:

Свойство	Тип данных	Описание
latitude	string	Широта (опционально)
longitude	string	Долгота (опционально)
timestamp	string	Метка (опционально)

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  try {
    const { payload: { latitude, longitude } } = await SDK.requestLocation();

    console.log(`lat = ${latitude}, lng = ${longitude}`);
  } catch(error) {
    console.log(error);
  }
}