wecom sdk

"Si cree que este proyecto es bueno, haga clic en la esquina superior derecha del proyecto para animar al autor, gracias".

Aviso

1. El código es completamente de código abierto; pruebe el proyecto de muestra detenidamente antes de usarlo.
2. Si encuentra un problema que no se puede resolver después de una serie de esfuerzos mientras intenta el paso 1, presente un problema o resuélvalo extendiendo el código usted mismo.

?Introducción

wecom-sdk es la implementación Java de la API abierta WeChat empresarial de código abierto. Actualmente es la implementación de código abierto de Java más completa. Después de casi tres años de iteración, se han implementado interfaces abiertas empresariales de WeChat, como gestión de libretas de direcciones, gestión de clientes, servicio al cliente de WeChat, gestión de materiales, envío de mensajes, microbots empresariales, verificación de identidad, gestión de aplicaciones, oficina de OA y pagos empresariales. Puede acceder de forma rápida y elegante a WeChat corporativo sin altos costos de aprendizaje.

?Muestra de robot 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 obtener más ejemplos.

característica

• Admite múltiples trabajos de configuración empresarial de WeChat al mismo tiempo
• Fácil de integrar y adecuado para varios ecosistemas Java
• Actualmente, se han implementado más de 200 interfaces WeChat empresariales, que pueden satisfacer las necesidades de la mayoría de los escenarios.
• Encapsulación completa de parámetros, los parámetros están encapsulados de manera altamente semántica y ya no tiene que preocuparse por organizar y analizar parámetros.
• Implemente devoluciones de llamadas unificadas, todos los eventos de devolución de llamadas se pueden procesar de forma centralizada y asincrónica, y los desarrolladores solo deben preocuparse por el procesamiento de la lógica empresarial.
• Manejo unificado de excepciones: WeComException administra de manera uniforme las excepciones de llamadas a la API empresarial de WeChat
• El SDK se hace cargo del ciclo de vida del token y los desarrolladores no necesitan preocuparse por la gestión del token.

En la actualidad, las aplicaciones creadas por uno mismo se pueden adaptar fácilmente, pero los proveedores de servicios y las agencias desarrolladoras no son de código abierto por el momento.

✍️Pila de tecnología

• Retrofit2, admite el número de versión más alto 2.11.0
• OkHttp4, admite el número de versión más alto 4.12.0
• Rxjava3, admite el número de versión más alto 3.1.8
• Jackson2, admite el número de versión más alto 2.15.2
• XStream, admite el número de versión más alto 1.4.20

?️Coordenadas del almacén central de Maven

• Versión normal

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

• versión rxjava

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

• ¿Cómo encontrar la API que deseas?

Dado que la implementación es demasiado completa, si desea encontrar la API con precisión, puede hacer esto:

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

Primero vaya a la documentación de la API Enterprise WeChat para encontrar la API que necesita, como crear una etiqueta https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN e interceptar tag/create en buscar a nivel mundial.

• Dependencias compatibles con la versión baja de Okhttp

El error NoSuchMethod se informa porque su proyecto mismo introdujo Okhttp, pero la versión es relativamente baja, lo que resulta en incompatibilidad. Puede introducir wecom-sdk a través de las siguientes dependencias.

< 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

No más documentación, el código es la documentación.

?Agradecimiento especial