go实现企业微信API，以第三方服务商角度整理的API，支持手动生成企业微信新API或新回调代码

企业微信第三方应用开发 go sdk

Go语言实现企业微信API，a sensible Work Weixin SDK for Go。

Github源码：https://github.com/zsmhub/workweixin

自动生成sdk代码命令

支持手动生成企业微信新API或新回调代码

生成api代码

make api doc=https://open.work.weixin.qq.com/api/doc/90001/90143/90600
生成callback代码

make callback doc=https://open.work.weixin.qq.com/api/doc/90001/90143/92277

sdk 调用示例

回调sdk调用示例

// 企微回调设置初始化
func InitCallbackHandler() error {
    // 服务商回调解析
  if err := workweixin.Sdk.NewProviderCallbackHandler(config.CorpCallbackToken, config.CorpCallbackEncodingAESKey); err != nil {
        return err
    }

    // 第三方应用回调解析
  if err := workweixin.Sdk.NewAppSuiteCallbackHandler(config.AppSuiteCallbackToken, config.AppSuiteCallbackEncodingAESKey); err != nil {
        return err
    }

    // 第三方小程序回调解析【可选】
  if err := workweixin.Sdk.NewMiniSuiteCallbackHandler(config.MiniSuiteCallbackToken, config.MiniSuiteCallbackEncodingAESKey); err != nil {
        return err
    }

    return nil
}

// 服务商-解析并获取回调信息
workweixin.Sdk.ProviderCallback.GetCallBackMsg(r *http.Request)

// 第三方应用-解析并获取回调信息
workweixin.Sdk.AppSuiteCallback.GetCallBackMsg(r *http.Request)

// 第三方小程序-解析并获取回调信息
workweixin.Sdk.MiniSuiteCallback.GetCallBackMsg(r *http.Request)

// 第三方应用回调完整示例
func HandleAppPostRequest(c echo.Context) error {
    msg, err := workweixin.Sdk.AppSuiteCallback.GetCallBackMsg(c.Request())
    if err != nil {
        return err
    }

    switch msg.MsgType {

    case callbacks.MessageTypeThird: // 第三方应用回调
      switch msg.EventType {

            case callbacks.InfoTypeSuiteTicket: // 每十分钟推送一次suite_ticket
  ticket := msg.Extras.(callbacks.ThirdSuiteTicket).SuiteTicket.Text
                workweixin.Sdk.ThirdAppClient.RefreshSuiteTicket(ticket)

                retryer := backoff.WithContext(backoff.NewExponentialBackOff(), context.Background())
                err := backoff.Retry(func() error {
                    // todo 将 suite_ticket 存储在数据库或其他地方
  return nil
                }, retryer)

                return err

    }

    return nil
}

api sdk调用示例

// 企微API客户端初始化
func InitApiHandler() error {
    // 服务商API客户端初始化
    workweixin.Sdk.NewProviderApiClient(config.CorpId, config.CorpProviderSecret)

    // 第三方应用API客户端初始化
  suiteTicket := "xxx" // 从数据库等地方获取已得到的suite_ticket
    workweixin.Sdk.NewThirdAppApiClient(config.CorpId, config.AppSuiteId, config.AppSuiteSecret, suiteTicket)

    // 授权企业API客户端初始化
  authCorpList := xxx.GetAuthCorpList() // 从数据库获取已授权企业
  for _, corp := range authCorpList {
        workweixin.Sdk.NewAuthCorpApiClient(corp.CorpId, corp.PermanentCode, workweixin.Sdk.ThirdAppClient)
    }

    return nil
}

// 获取企业永久授权码
resp, err := workweixin.Sdk.ThirdAppClient.ExecGetPermanentCodeService(apis.ReqGetPermanentCodeService{AuthCode: authCode})

// 企微 error code 处理
if err != nil {
    apiError, _ := err.(*apis.ClientError)
    if apiError.Code == apis.ErrCode60011 {
        return nil, errors.New("无权限访问")
    }
    return nil, err
}

// 推送消息到第三方应用
apiClient, err := workweixin.Sdk.GetAuthCorpAPPClient(v.CorpId)
if err != nil {
    fmt.Println(err)
}
reqSentMessageCard := apis.ReqSentMessageCard{
    ToUser:  v.InstallUserId,
    MsgType: "news",
    AgentId: v.AgentId,
    News: apis.ReqSentMessageCardNewsBody{
        Articles: []apis.ReqSentMessageCardNewsArticleBody{
            {
                Title:       "新模块【xxx】已上线",
                Description: "快进入【管理后台】把它配置到你的【侧边栏】中！",
                Url:         "https://xxx",
                UrlImg:      "https://xxx/workbench-config.jpg",
            },
        },
    },
}
if _, err = apiClient.ExecSentMessageCard(reqSentMessageCard); err != nil {
    fmt.Println(err)
}