Быстрый старт
Данный раздел описывает технические моменты, необходимые для начала интеграции.
Полноценная реализация и описание API Reference еще в процессе и требует с нашей стороны доработки, но сигнатуры методов менять не планируется.
Доступы к сервисам
Для подключения доступны production и stage окружения, для начала интеграции стоит использовать данные для stage.
Для получения доступа к окружению необходим специальный токен, который генерируется по запросу. Он используется для первоначального соединения между сервисами, далее авторизация происходит посредством пользовательских токенов.
Установить зависимости
В данном руководстве приводятся примеры интеграции для NodeJS и TypeScript.
Для начала работы следует установить пакеты @protobuf-ts/grpc-transport и @grpc/grpc-js
Транспорт и авторизация
Для работы с gRPC требуется создать две вспомогательные функции для создания контейнера для передачи команд на удаленный сервис и для авторизации. Необязательно, но повышает удобство использования.
Обратите внимание, что в данном примере используется переменная окружения SERVICES_API_URL
. Если у вас имя данной переменной отличается, необходимо отредактировать пример кода под свои нужды.
Первый запрос
В качестве тестового начального запроса можно использовать запрос к сервису определения местоположения по IP адресу. Он не требует авторизации.
Для начала, стоит скачать сгенерированный клиент для этого сервиса, распаковать и скопировать в папку src/services
.
Далее пример использования клиента для вызова необходимых методов у сервиса, в данном случае для получения сведений о текущем местоположении и флага, который сообщает, разрешен доступ или нет.
Пример приложения для проверки локации прикреплен ниже в виде архива.
Last updated