Lanxin SDK для Java

Обзор

Для того чтобы разработчикам на Java было проще подключаться к открытой платформе Lanxin, используйте интерфейсы открытой платформы Lanxin. В этом документе мы предоставляем этот SDK для разработки.
В настоящее время предоставляются только важные реализации интерфейсов для аутентификации и авторизации, адресной книги и уведомления о сообщениях. Остальные интерфейсы будут постепенно открываться в зависимости от использования.
Если этот SDK не удовлетворяет потребностям вашего бизнеса, пожалуйста, напрямую используйте официальный REST API или свяжитесь с разработчиком этого SDK (WeChat ID: Z2013111158), чтобы открыть необходимые вам другие интерфейсы.

Среда выполнения

Версия Java ≥ 1.8

Использование

1. Добавление зависимостей

Maven:

<dependency>
    <groupId>com.nmgolden</groupId>
    <artifactId>lanxin-sdk</artifactId>
    <version>0.13.1</version>
</dependency>

Gradle:

implementation 'com.nmgolden:lanxin-sdk:0.13.1'

2. Инициализация объекта LanxinService

// Инициализируем объект конфигурации Lanxin
LanxinAppConfig config = new LanxinAppConfig();
config.setAppId(appId);
config.setAppSecret(appSecret);
config.setApiGateway(apiGateway);

// Создаём объект службы
LanxinService lanxinService = new DefaultLanxinService(config);

appId, appSecret и apiGateway можно найти на открытой платформе Lanxin.

3. Использование объекта LanxinService для вызова интерфейса

// Получаем идентификатор пользователя Lanxin staffId , код: код для входа без аутентификации
String staffId = lanxinService.getStaffIdByCode(code);

// По идентификатору staffId получаем подробную информацию о пользователе
UserDetail userDetail = lanxinService.getUserDetail(staffId);

// Отправляем текстовое сообщение
mLanxinService.sendTextMessage("1572864-JWuRLcnaBGVjC5ab5IggKvC20b2a", "Тестовый текст");

// Отправим карточку сообщения OA
List<MsgDataField> fields = new ArrayList<>();
fields.add(new MsgDataField("Метка 1", "Значение метки 1"));
fields.add(new MsgDataField("Метка 2", "Значение метки 2"));
lanXinService.sendOaCardMessage(staffId,
        "У вас есть новое сообщение",
        "Подзаголовок",
        fields,
        "https://example.com");

История версий

0.15.2

Дата выпуска:

• Добавлено — удалены ненужные пакеты.

0.15.1

Дата выпуска: 2024/05/28

• Добавлено — удалены ненужные пакеты.

0.15.0

Дата выпуска: 2024/05/18

• Добавлено — завершены оставшиеся интерфейсы управления персоналом и управления филиалами.
• Реорганизована структура кода.

0.14.0

Дата выпуска: 2024/05/16

• Добавлено — интерфейс получения конфигурации.

0.13.2

Дата выпуска: 2024/04/30

• Исправлено — проблема, из-за которой максимальное количество подключений httpClient по умолчанию равно 2, что может привести к блокировке новых запросов.

0.13.1

Дата выпуска: 2024/02/21

• Исправлено — ошибка метода revokeMessage.

0.13.0

Дата выпуска: 2024/02/02

• Добавлено — метод getDepartmentAncestors4User.

0.12.0

Дата выпуска: 2024/01/23

• Добавлено — методы загрузки и скачивания файлов мультимедиа, а также метод получения пути загрузки файла мультимедиа.
• Добавлено — отправка сообщений по ссылке поддерживает различие между мобильным терминалом и ПК.

0.11.0

Дата выпуска: 2023/12/21

• Добавлено — перегрузка метода sendLinkCardMessage.

0.10.0

Дата выпуска: 2023/12/18

• Изменено — тип класса code изменён с Exception на int.

0.9.0

Дата выпуска: 2023/12/09

• Изменён — объект сведений о пользователе: добавлен extraFieldSet.

0.8.0

Дата выпуска: 2023/12/08

• Добавлено — метод получения списка расширенных полей адресной книги.

0.7.0

Дата выпуска: 2023/11/08

• Добавлено — перегрузка методов отправки групповых сообщений webhook робота (использование подробной информации о сообщении для отправки).
• Добавлено — перегрузка методов отправки групповых сообщений webhook робота (проверка законности сообщения с использованием подписи).

0.6.0

Дата выпуска: 2023/10/31

• Добавлено — отправка типов сообщений appCard и обновление сообщений appCard.
• Добавлено — webhook робот отправляет групповые сообщения.
• Добавлено — отправка текстовых сообщений с возможностью указания идентификатора данных персонала.

0.5.0

Дата выпуска: 2023/09/05

• Добавлено — при получении филиала можно получить количество людей в филиале.

0.4.0

Дата выпуска: 2023/08/24

• Добавлено — получение оператора приложения.
• Добавлено — отправка уведомлений приложения, обновление состояния сеанса уведомления.

0.3.0

Дата выпуска: 2022/04/04

• Изменено — параметры метода обновления пользователя изменены на Map.

0.2.0

Дата выпуска: 2022/06/01

• Добавлено — метод getStaffIdByCode.
• Добавлено — метод OrgId.
• Добавлено — метод отзыва сообщения.
• Исправлено — конфликт токенов нескольких экземпляров.

0.1.0

Дата выпуска: 2022/05/13

• Некоторые проблемы решены.
• Используется httpClient для сетевых запросов.

0.0.1

Дата выпуска: 2020

Основные функции.