wecom sdk

?Jika Anda merasa proyek ini bagus, silakan klik di sudut kanan atas proyek untuk menyemangati penulis, terima kasih?.

Melihat

1. Kode ini sepenuhnya open source, silakan coba proyek sampel dengan cermat sebelum menggunakannya.
2. Jika Anda mengalami masalah yang tidak dapat diselesaikan setelah serangkaian upaya saat mencoba langkah 1, ajukan masalah atau selesaikan dengan memperluas kode sendiri.

?Perkenalan

wecom-sdk adalah implementasi Java dari API terbuka WeChat perusahaan open source. Saat ini merupakan implementasi open source Java yang paling lengkap. Setelah hampir tiga tahun iterasi, antarmuka terbuka WeChat perusahaan seperti manajemen buku alamat, manajemen pelanggan, layanan pelanggan WeChat, manajemen material, push pesan, mikrobot perusahaan, verifikasi identitas, manajemen aplikasi, kantor OA, dan pembayaran perusahaan telah diterapkan Anda dapat mengakses WeChat perusahaan dengan cepat dan elegan tanpa biaya pembelajaran yang mahal.

?Sampel 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 ());
        
}

Lihat SpringBootWecomSdkTests.java untuk contoh selengkapnya

ciri

• Mendukung beberapa pekerjaan konfigurasi WeChat perusahaan secara bersamaan
• Mudah diintegrasikan dan cocok untuk berbagai ekosistem Java
• Saat ini, lebih dari 200 antarmuka WeChat perusahaan telah diterapkan, yang dapat memenuhi kebutuhan sebagian besar skenario.
• Enkapsulasi parameter penuh, parameter dienkapsulasi secara semantik, dan Anda tidak perlu lagi khawatir tentang mengatur parameter dan mengurai parameter.
• Menerapkan panggilan balik terpadu, semua peristiwa panggilan balik dapat diproses secara terpusat dan asinkron, dan pengembang hanya perlu memperhatikan pemrosesan logika bisnis
• Penanganan pengecualian terpadu, pengecualian panggilan API WeChat perusahaan dikelola secara seragam oleh WeComException
• SDK mengambil alih siklus hidup Token, dan pengembang tidak perlu peduli dengan manajemen Token.

Saat ini, aplikasi yang dibuat sendiri dapat dengan mudah diadaptasi, namun penyedia layanan dan pengembang agensi belum bersifat open source untuk saat ini.

✍️ Tumpukan teknologi

• Retrofit2, mendukung nomor versi tertinggi 2.11.0
• OkHttp4, mendukung nomor versi tertinggi 4.12.0
• Rxjava3, mendukung nomor versi tertinggi 3.1.8
• Jackson2, mendukung nomor versi tertinggi 2.15.2
• XStream, mendukung nomor versi tertinggi 1.4.20

?️Koordinat gudang pusat Maven

• Versi biasa

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

• versi rxjava

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

• Bagaimana cara menemukan API yang Anda inginkan?

Karena implementasinya terlalu lengkap, jika Anda ingin menemukan API secara akurat, Anda dapat melakukan ini:

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

Pertama, buka dokumentasi Enterprise WeChat API untuk menemukan API yang Anda perlukan, seperti membuat tag https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN , dan mencegat tag/create ke mencari secara global.

• Dependensi kompatibel versi rendah Okhttp

Kesalahan NoSuchMethod dilaporkan karena proyek Anda sendiri telah memperkenalkan Okhttp, tetapi versinya relatif rendah, sehingga menyebabkan ketidakcocokan. Anda dapat memperkenalkan wecom-sdk melalui dependensi berikut.

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

dokumen

Tidak ada lagi dokumentasi, kodenya adalah dokumentasinya

?Terima kasih khusus