wecom sdk

?Se você acha que este projeto é bom, clique no canto superior direito do projeto para incentivar o autor, obrigado?.

Perceber

1. O código é totalmente de código aberto. Experimente o projeto de exemplo com atenção antes de usá-lo.
2. Se você encontrar um problema que não pode ser resolvido após uma série de esforços ao tentar a etapa 1, registre um problema ou resolva-o estendendo o código você mesmo.

?Introdução

wecom-sdk é a implementação Java da API aberta WeChat empresarial de código aberto. Atualmente é a implementação de código aberto Java mais completa. Após quase três anos de iteração, foram implementadas interfaces abertas do WeChat corporativo, como gerenciamento de catálogo de endereços, gerenciamento de clientes, atendimento ao cliente WeChat, gerenciamento de materiais, envio de mensagens, microbots corporativos, verificação de identidade, gerenciamento de aplicativos, escritório OA e desenvolvedores de pagamentos corporativos. Você pode acessar o WeChat corporativo de forma rápida e elegante, sem altos custos de aprendizado.

?Amostra do robô 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 ());
        
}

Consulte SpringBootWecomSdkTests.java para obter mais exemplos

característica

• Suporta vários trabalhos de configuração empresarial do WeChat ao mesmo tempo
• Fácil de integrar e adequado para vários ecossistemas Java
• Atualmente, mais de 200 interfaces empresariais WeChat foram implementadas, o que pode atender às necessidades da maioria dos cenários.
• Encapsulamento completo de parâmetros, os parâmetros são altamente encapsulados semanticamente e você não precisa mais se preocupar em organizar e analisar parâmetros.
• Implemente retornos de chamada unificados, todos os eventos de retorno de chamada podem ser processados ​​de forma centralizada e assíncrona, e os desenvolvedores só precisam se preocupar com o processamento da lógica de negócios
• Tratamento unificado de exceções, exceções de chamadas corporativas da API WeChat são gerenciadas uniformemente por WeComException
• O SDK assume o ciclo de vida do token e os desenvolvedores não precisam se preocupar com o gerenciamento do token.

Atualmente, os aplicativos autoconstruídos podem ser facilmente adaptados, mas os provedores de serviços e os desenvolvedores de agências não são de código aberto por enquanto.

✍️Pilha de tecnologia

• Retrofit2, suporta o número de versão mais alto 2.11.0
• OkHttp4, suporta o número de versão mais alto 4.12.0
• Rxjava3, suporta o número de versão mais alto 3.1.8
• Jackson2, suporta o número de versão mais alto 2.15.2
• XStream, suporta o número de versão mais alto 1.4.20

?️Coordenadas do armazém central Maven

• Versão normal

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

• versão rxjava

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

• Como encontrar a API que você deseja?

Como a implementação é muito completa, se quiser encontrar a API com precisão, você pode fazer o seguinte:

 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 ;
}    

Primeiro, acesse a documentação da API Enterprise WeChat para encontrar a API necessária, como criar uma tag https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN e interceptar tag/create para pesquise globalmente.

• Okhttp dependências compatíveis com versão baixa

O erro NoSuchMethod é relatado porque seu próprio projeto introduziu Okhttp, mas a versão é relativamente baixa, resultando em incompatibilidade. Você pode introduzir wecom-sdk por meio das seguintes dependências.

< 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 >

documento

Chega de documentação, o código é a documentação

?Agradecimentos especiais