wecom sdk

?หากคุณรู้สึกว่าโครงการนี้ดี กรุณาคลิกมุมขวาบนของโครงการเพื่อให้กำลังใจผู้เขียน ขอบคุณครับ?.

สังเกต

1. โค้ดนี้เป็นโอเพ่นซอร์สโดยสมบูรณ์ โปรดลองใช้โปรเจ็กต์ตัวอย่างอย่างรอบคอบก่อนใช้งาน
2. หากคุณพบปัญหาที่ไม่สามารถแก้ไขได้หลังจากพยายามหลายครั้งในขณะที่ลองขั้นตอนที่ 1 โปรดแจ้งปัญหาหรือแก้ไขโดยขยายโค้ดด้วยตนเอง

?การแนะนำ

wecom-sdk เป็นการใช้งาน Java ของ WeChat open API ขององค์กรโอเพ่นซอร์สที่สมบูรณ์แบบที่สุดในปัจจุบัน หลังจากทำซ้ำมาเกือบสามปี อินเทอร์เฟซแบบเปิดของ 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 ต่างๆ
• ปัจจุบัน มีการใช้งานอินเทอร์เฟซ WeChat ระดับองค์กรมากกว่า 200 รายการ ซึ่งสามารถตอบสนองความต้องการของสถานการณ์ส่วนใหญ่ได้
• การห่อหุ้มพารามิเตอร์แบบเต็ม พารามิเตอร์มีการห่อหุ้มเชิงความหมายอย่างมาก และคุณไม่ต้องกังวลกับการจัดระเบียบพารามิเตอร์และพารามิเตอร์การแยกวิเคราะห์อีกต่อไป
• ใช้การโทรกลับแบบรวม กิจกรรมการโทรกลับทั้งหมดสามารถประมวลผลจากส่วนกลางและไม่พร้อมกันได้ และนักพัฒนาจำเป็นต้องดูแลเกี่ยวกับการประมวลผลตรรกะทางธุรกิจเท่านั้น
• การจัดการข้อยกเว้นแบบรวม ข้อยกเว้นการเรียก WeChat API ขององค์กรได้รับการจัดการอย่างสม่ำเสมอโดย WeComException
• SDK เข้าควบคุมวงจรชีวิตของโทเค็น และนักพัฒนาไม่จำเป็นต้องสนใจเกี่ยวกับการจัดการโทเค็น

ปัจจุบันแอปพลิเคชันที่สร้างขึ้นเองสามารถปรับเปลี่ยนได้ง่าย แต่ผู้ให้บริการและผู้พัฒนาเอเจนซี่ยังไม่ใช่โอเพ่นซอร์สในขณะนี้

✍️กองเทคโนโลยี

• Retrofit2 รองรับเวอร์ชันสูงสุดหมายเลข 2.11.0
• OkHttp4 รองรับเวอร์ชันสูงสุด 4.12.0
• Rxjava3 รองรับเวอร์ชันสูงสุดหมายเลข 3.1.8
• Jackson2 รองรับเวอร์ชันสูงสุดหมายเลข 2.15.2
• XStream รองรับเวอร์ชันสูงสุดหมายเลข 1.4.20

️พิกัดโกดังกลางมาเวน

• รุ่นปกติ

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

เอกสาร

ไม่มีเอกสารประกอบอีกต่อไป รหัสคือเอกสารประกอบ

ขอขอบคุณเป็นพิเศษ