feat: 获取访问用户身份

Author: Nottwoc

README.md

@@ -82,6 +82,7 @@ CI 会在 `go1.17` 和 Go 的当前稳定版本、上一个稳定版本上跑测
 * [x] OA (**大部分支持**，见下)
 * [x] 会话内容存档 (**大部分支持**，见下)
 * [x] 企业微信登录接口 (code2Session)
+* [x] 获取访问用户身份 (code2UserInfo)
 
 <details>
 <summary>通讯录管理 API</summary>

apis.md.go

@@ -8,6 +8,7 @@ Name|Request Type|Response Type|Access Token|URL|Doc
 `execGetJSAPITicket`|`reqJSAPITicket`|`respJSAPITicket`|+|`GET /cgi-bin/get_jsapi_ticket`|[获取企业的jsapi_ticket](https://open.work.weixin.qq.com/api/doc/90000/90136/90506)
 `execGetJSAPITicketAgentConfig`|`reqJSAPITicketAgentConfig`|`respJSAPITicket`|+|`GET /cgi-bin/ticket/get`|[获取应用的jsapi_ticket](https://open.work.weixin.qq.com/api/doc/90000/90136/90506)
 `execJSCode2Session`|`reqJSCode2Session`|`respJSCode2Session`|+|`GET /cgi-bin/miniprogram/jscode2session`|[临时登录凭证校验code2Session](https://open.work.weixin.qq.com/api/doc/90000/90136/91507)
+`execAuthCode2UserInfo`|`reqAuthCode2UserInfo`|`respAuthCode2UserInfo`|+|`GET /cgi-bin/auth/getuserinfo`|[获取访问用户身份](https://developer.work.weixin.qq.com/document/path/91023)
 
 # 成员管理
 

docs/apis.md

@@ -739,6 +739,33 @@ type JSCodeSession struct {
 	SessionKey string `json:"session_key"`
 }
 
+// reqAuthCode2UserInfo 获取访问用户身份
+type reqAuthCode2UserInfo struct {
+	Code string
+}
+
+var _ urlValuer = reqAuthCode2UserInfo{}
+
+func (x reqAuthCode2UserInfo) intoURLValues() url.Values {
+	return url.Values{
+		"code": {x.Code},
+	}
+}
+
+// respAuthCode2UserInfo 获取访问用户身份响应
+type respAuthCode2UserInfo struct {
+	respCommon
+	AuthCodeUserInfo
+}
+
+// AuthCodeUserInfo 访问用户身份
+type AuthCodeUserInfo struct {
+	UserID         string `json:"userid,omitempty"`
+	UserTicket     string `json:"user_ticket,omitempty"`
+	OpenID         string `json:"openid,omitempty"`
+	ExternalUserID string `json:"external_userid,omitempty"`
+}
+
 type reqMsgAuditListPermitUser struct {
 	MsgAuditEdition MsgAuditEdition `json:"type"`
 }

errcodes/mod.go

@@ -234,3 +234,12 @@ func (c *WorkwxApp) JSCode2Session(jscode string) (*JSCodeSession, error) {
 	}
 	return &resp.JSCodeSession, nil
 }
+
+// AuthCode2UserInfo 获取访问用户身份
+func (c *WorkwxApp) AuthCode2UserInfo(code string) (*AuthCodeUserInfo, error) {
+	resp, err := c.execAuthCode2UserInfo(reqAuthCode2UserInfo{Code: code})
+	if err != nil {
+		return nil, err
+	}
+	return &resp.AuthCodeUserInfo, nil
+}