wecom sdk

«Если вы считаете, что этот проект хорош, нажмите на верхний правый угол проекта, чтобы поощрить автора, спасибо».

Уведомление

1. Код полностью с открытым исходным кодом, пожалуйста, внимательно попробуйте пример проекта перед его использованием.
2. Если вы столкнулись с проблемой, которую не удается решить после ряда усилий при выполнении шага 1, сообщите о проблеме или решите ее, расширив код самостоятельно.

?Введение

wecom-sdk — это Java-реализация корпоративного открытого API WeChat с открытым исходным кодом. На данный момент это наиболее полная реализация Java с открытым исходным кодом. После почти трех лет итераций были реализованы корпоративные открытые интерфейсы WeChat, такие как управление адресной книгой, управление клиентами, обслуживание клиентов WeChat, управление материалами, рассылка сообщений, корпоративные микроботы, проверка личности, управление приложениями, офис OA и корпоративные платежи. Разработчики. Вы можете быстро и элегантно получить доступ к корпоративному WeChat без больших затрат на обучение.

?Образец робота Qiwei

 /**
 * 企微机器人
 *
 * @throws IOException the io exception
 */
@ Test
void webHooks () throws IOException {
        // 发 markdown
        WebhookBody markdownBody = WebhookMarkdownBody . from ( "这里为markdown消息" );
        // 发纯文本
        WebhookBody textBody = WebhookTextBody . from ( "这里为纯文本" );
        // 发图文
        WebhookArticle article = new WebhookArticle ( "这里为标题" , "这里为图文链接" )
                                   . picurl ( "这里为封面图链接" )
                                   . description ( "这里为摘要信息" );
        WebhookBody newsBody = WebhookNewsBody . from ( Collections . singletonList ( article ));
        // 从base64发图片
        String base64 = "图片base64" ;
        String md5 = "图片base64的md5" ;
        WebhookBody imageBody1 = WebhookImageBody . from ( base64 , md5 );
        // 从流发送图片
        String path = "C: \ Users \ Administrator \ Desktop \ 0.png" ;
        InputStream inputStream = Files . newInputStream ( Paths . get ( path ));
        WebhookBody imageBody2 = WebhookImageBody . from ( inputStream );
        WeComResponse weComResponse = WorkWeChatApi . webhookApi (). send ( "机器人key" , markdownBody );
        Assertions . assertTrue ( weComResponse . isSuccessful ());
        
}

Дополнительные примеры см. в SpringBootWecomSdkTests.java.

характеристика

• Одновременная поддержка нескольких заданий по настройке корпоративного WeChat
• Легко интегрируется и подходит для различных экосистем Java.
• В настоящее время реализовано более 200 корпоративных интерфейсов WeChat, которые могут удовлетворить потребности большинства сценариев.
• Полная инкапсуляция параметров: параметры высоко семантически инкапсулированы, и вам больше не придется беспокоиться об организации параметров и параметрах синтаксического анализа.
• Реализуйте унифицированные обратные вызовы, все события обратного вызова могут обрабатываться централизованно и асинхронно, а разработчикам нужно заботиться только об обработке бизнес-логики.
• Унифицированная обработка исключений, исключения вызовов корпоративного API WeChat единообразно управляются WeComException.
• SDK берет на себя жизненный цикл токена, и разработчикам не нужно заботиться об управлении токенами.

В настоящее время самостоятельно созданные приложения можно легко адаптировать, но поставщики услуг и разработчики агентств пока не имеют открытого исходного кода.

✍️Стек технологий

• Retrofit2, поддерживает самый высокий номер версии 2.11.0
• OkHttp4, поддерживает максимальный номер версии 4.12.0
• Rxjava3, поддерживает самый высокий номер версии 3.1.8
• Jackson2, поддерживает максимальный номер версии 2.15.2
• XStream поддерживает максимальный номер версии 1.4.20

?️Координаты центрального склада Maven

• Обычная версия

< dependency >
    < groupId >cn.felord</ groupId >
    < artifactId >wecom-sdk</ artifactId >
    < version >1.3.2</ version >
</ dependency >

• версия rxjava

< dependency >
    < groupId >cn.felord</ groupId >
    < artifactId >rx-wecom-sdk</ artifactId >
    < version >1.3.2</ version >
</ dependency >

• Как найти нужный API?

Поскольку реализация слишком полная, если вы хотите точно найти API, вы можете сделать это:

 public interface TagApi {

    /**
     * 创建标签
     *
     * @param request the request
     * @return GenericResponse generic response
     * @throws WeComException the weComException
     */
    @ POST ( "tag/create" )
    GenericResponse < String > createTag ( @ Body Tag request ) throws WeComException ;
}    

Сначала перейдите к документации Enterprise WeChat API, чтобы найти нужный вам API, например, создайте тег https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN и перехватите tag/create для искать по всему миру.

• Зависимости, совместимые с низкой версией Okhttp

Сообщается об ошибке NoSuchMethod, поскольку сам проект использует Okhttp, но его версия относительно низкая, что приводит к несовместимости. Вы можете ввести wecom-sdk с помощью следующих зависимостей.

< dependency >
    < groupId >cn.felord</ groupId >
    < artifactId >wecom-sdk</ artifactId >
    < version >1.3.2</ version >
    < exclusions >
        < exclusion >
            < groupId >com.squareup.okhttp3</ groupId >
            < artifactId >okhttp</ artifactId >
        </ exclusion >
        < exclusion >
            < groupId >com.squareup.okhttp3</ groupId >
            < artifactId >logging-interceptor</ artifactId >
        </ exclusion >
    </ exclusions >
</ dependency >

< dependency >
    < groupId >com.squareup.okhttp3</ groupId >
    < artifactId >okhttp</ artifactId >
    < version >4.12.0</ version >
</ dependency >

< dependency >
    < groupId >com.squareup.okhttp3</ groupId >
    < artifactId >logging-interceptor</ artifactId >
    < version >4.12.0</ version >
</ dependency >

документ

Больше никакой документации, код — это документация

?Особая благодарность