wecom sdk

„Wenn Sie der Meinung sind, dass dieses Projekt gut ist, klicken Sie bitte auf die obere rechte Ecke des Projekts, um den Autor zu ermutigen. Vielen Dank.“

Beachten

1. Der Code ist vollständig Open Source. Bitte testen Sie das Beispielprojekt sorgfältig, bevor Sie es verwenden.
2. Wenn Sie beim Ausprobieren von Schritt 1 auf ein Problem stoßen, das nach einer Reihe von Versuchen nicht gelöst werden kann, melden Sie bitte ein Problem oder lösen Sie es, indem Sie den Code selbst erweitern.

?Einführung

wecom-sdk ist die Java-Implementierung der Open-Source-Enterprise-API WeChat. Es ist derzeit die vollständigste Java-Open-Source-Implementierung. Nach fast dreijähriger Iteration wurden offene WeChat-Schnittstellen für Unternehmen wie Adressbuchverwaltung, Kundenverwaltung, WeChat-Kundenservice, Materialverwaltung, Nachrichten-Push, Unternehmens-Microbots, Identitätsprüfung, Anwendungsverwaltung, OA-Büro und Unternehmenszahlungsentwickler implementiert Sie können ohne hohe Lernkosten schnell und elegant auf Unternehmens-WeChat zugreifen.

?Qiwei-Roboterprobe

 /**
 * 企微机器人
 *
 * @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 ());
        
}

Weitere Beispiele finden Sie unter SpringBootWecomSdkTests.java

Merkmal

• Unterstützen Sie mehrere WeChat-Konfigurationsjobs für Unternehmen gleichzeitig
• Einfach zu integrieren und für verschiedene Java-Ökosysteme geeignet
• Derzeit wurden mehr als 200 WeChat-Schnittstellen für Unternehmen implementiert, die den Anforderungen der meisten Szenarien gerecht werden.
• Vollständige Parameterkapselung, Parameter sind stark semantisch gekapselt und Sie müssen sich nicht mehr um die Organisation von Parametern und das Parsen von Parametern kümmern.
• Durch die Implementierung einheitlicher Rückrufe können alle Rückrufereignisse zentral und asynchron verarbeitet werden, und Entwickler müssen sich nur um die Verarbeitung der Geschäftslogik kümmern
• Einheitliche Ausnahmebehandlung, Ausnahmen von WeChat-API-Aufrufen für Unternehmen werden einheitlich von WeComException verwaltet
• Das SDK übernimmt den Token-Lebenszyklus und Entwickler müssen sich nicht um die Token-Verwaltung kümmern.

Derzeit lassen sich selbst erstellte Anwendungen leicht anpassen, Dienstleister und Agenturentwickler sind jedoch vorerst nicht Open Source.

✍️Technologie-Stack

• Retrofit2 unterstützt die höchste Versionsnummer 2.11.0
• OkHttp4, unterstützt die höchste Versionsnummer 4.12.0
• Rxjava3 unterstützt die höchste Versionsnummer 3.1.8
• Jackson2 unterstützt die höchste Versionsnummer 2.15.2
• XStream unterstützt die höchste Versionsnummer 1.4.20

?️Maven-Zentrallagerkoordinaten

• Normale Version

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

• rxjava-Version

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

• Wie finden Sie die gewünschte API?

Da die Implementierung zu vollständig ist, können Sie Folgendes tun, wenn Sie die API genau finden möchten:

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

Rufen Sie zunächst die Enterprise WeChat API-Dokumentation auf, um die API zu finden, die Sie benötigen, z. B. das Erstellen eines Tags https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN und das Abfangen tag/create für global suchen.

• Okhttp-kompatible Abhängigkeiten mit niedriger Version

Der NoSuchMethod-Fehler wird gemeldet, weil Ihr Projekt selbst Okhttp eingeführt hat, die Version jedoch relativ niedrig ist, was zu Inkompatibilität führt. Sie können wecom-sdk über die folgenden Abhängigkeiten einführen.

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

dokumentieren

Keine Dokumentation mehr, der Code ist die Dokumentation

„Besonderer Dank.“