service

package
v1.0.30 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 25, 2022 License: Zlib Imports: 11 Imported by: 0

README

服务商

Documentation

Index

Constants

View Source 
const (
	KItCreateAuth         = "create_auth"
	KItChangeAuth         = "change_auth"
	KItCancelAuth         = "cancel_auth"
	KItChangeContact      = "change_contact"
	KItShareAgentChange   = "share_agent_change"
	KItResetPermanentCode = "reset_permanent_code"
)
View Source 
const (
	KCtCreateUser = "create_user"
	KCtUpdateUser = "update_user"
	KCtDeleteUser = "delete_user"
)
View Source 
const (
	KCtCreateParty = "create_party"
	KCtUpdateParty = "update_party"
	KCtDeleteParty = "delete_party"
)
View Source 
const (
	KCtUpdateTag = "update_tag"
)

Variables

This section is empty.

Functions

func CorpIdToOpenCorpId 

func CorpIdToOpenCorpId(api *token.Api, corpId string) (string, error)

CorpIdToOpenCorpId 明文corpid转换为加密corpid POST（HTTPS） 为更好地保护企业与用户的数据，第三方应用获取的corpid不再是明文的corpid，将升级为第三方服务商级别的加密corpid（了解更多）。第三方可以将已有的明文corpid转换为第三方的加密corpid。 请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/corpid_to_opencorpid?provider_access_token=ACCESS_TOKEN

func GetAppQrCode 

func GetAppQrCode(api *token.Api, qr QRCodeReq) (string, error)

GetAppQrCode 获取应用二维码 POST（HTTPS） 用于获取第三方应用二维码。 https://qyapi.weixin.qq.com/cgi-bin/service/get_app_qrcode?suite_access_token=SUITE_ACCESS_TOKEN

func GetCorpToken 

func GetCorpToken(corp token.Token, d data.D) (access.Token, error)

GetCorpToken 获取企业凭证 POST（HTTPS） 第三方服务商在取得企业的永久授权码后，通过此接口可以获取到企业的access_token。 获取后可通过通讯录、应用、消息等企业接口来运营这些应用。 此处获得的企业access_token与企业获取access_token拿到的token，本质上是一样的，只不过获取方式不同。 获取之后，就跟普通企业一样使用token调用API接口 https://qyapi.weixin.qq.com/cgi-bin/service/get_corp_token?suite_access_token=SUITE_ACCESS_TOKEN

func GetPermanentCode 

func GetPermanentCode(corp token.Token, d data.D) (access.Token, error)

GetPermanentCode 获取企业永久授权码 POST（HTTPS）https://qyapi.weixin.qq.com/cgi-bin/service/get_permanent_code

func GetProviderToken 

func GetProviderToken(corp token.Token, d data.D) (access.Token, error)

GetProviderToken 获取服务商凭证 开发者需要缓存provider_access_token，用于后续接口的调用（注意：不能频繁调用get_provider_token接口，否则会受到频率拦截）。 当provider_access_token失效或过期时，需要重新获取。 provider_access_token的有效期通过返回的expires_in来传达，正常情况下为7200秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的provider_access_token。 provider_access_token至少保留512字节的存储空间。 企业微信可能会出于运营需要，提前使provider_access_token失效，开发者应实现provider_access_token失效时重新获取的逻辑

func GetSuiteToken 

func GetSuiteToken(corp token.Token, d data.D) (access.Token, error)

GetSuiteToken 获取第三方应用凭证 ticket suite_ticket 由于第三方服务商可能托管了大量的企业，其安全问题造成的影响会更加严重，故API中除了合法来源IP校验之外，还额外增加了suite_ticket作为安全凭证。 获取suite_access_token时，需要suite_ticket参数。suite_ticket由企业微信后台定时推送给“指令回调URL”，每十分钟更新一次，见推送suite_ticket。 suite_ticket实际有效期为30分钟，可以容错连续两次获取suite_ticket失败的情况，但是请永远使用最新接收到的suite_ticket。 通过本接口获取的suite_access_token有效期为2小时，开发者需要进行缓存，不可频繁获取。

func LICActiveAccount added in v1.0.23 

func LICActiveAccount(api *token.Api, activeCode string, userId string)

LICActiveAccount 激活帐号 下单购买帐号并支付完成之后，先调用获取订单中的帐号列表接口获取到帐号激活码，然后可以调用该接口将激活码绑定到某个企业员工，以对其激活相应的平台服务能力。 1. 一个userid允许激活一个基础帐号以及一个互通帐号。 2. 若userid已激活，使用同类型的激活码来激活后，则绑定关系变为新激活码，新激活码有效时长自动叠加上旧激活码剩余时长，同时旧激活码失效。 3. 为了避免服务商调用出错，多个同类型的激活码累加后的有效期不可超过5年，否则接口报错701030。 4.为了避免服务商调用出错，只有当旧的激活码的剩余使用小于等于20天，才可以使用新的同类型的激活码进行激活并续期 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/active_account?provider_access_token=ACCESS_TOKEN

func LICActiveCodeDetail added in v1.0.23 

func LICActiveCodeDetail(api *token.Api, activeCode string)

LICActiveCodeDetail 获取激活码详情 查询某个帐号激活码的状态以及激活绑定情况。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_active_info_by_code?provider_access_token=ACCESS_TOKEN

func LICBatchActiveAccount added in v1.0.23 

func LICBatchActiveAccount(api *token.Api, codes []ActiveCode)

LICBatchActiveAccount 批量激活帐号 可在一次请求里为一个企业的多个成员激活许可帐号，便于服务商批量化处理。

1.一个userid允许激活一个基础帐号以及一个互通帐号。 2. 若userid已激活，使用同类型的激活码来激活后，则绑定关系变为新激活码，新激活码有效时长自动叠加上旧激活码剩余时长，同时旧激活码失效。 3. 为了避免服务商调用出错，多个同类型的激活码累加后的有效期不可超过5年，否则接口报错701030。 4.为了避免服务商调用出错，只有当旧的激活码的剩余使用小于等于20天，才可以使用新的同类型的激活码进行激活并续期 5. 单次激活的员工数量不超过1000 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/batch_active_account?provider_access_token=ACCESS_TOKEN

func LICBatchShareActiveCode added in v1.0.23 

func LICBatchShareActiveCode(api *token.Api)

LICBatchShareActiveCode 分配激活码给下游企业 服务商可调用该接口将为上游企业购买的激活码分配给下游企业使用。

(1) 上游企业有共享该服务商的应用给下游企业，应用包括第三方应用和代开发应用 (2) 分配给下游企业的激活码，当前未激活，且属于上游企业的，且未分配给其他下游企业 (3) 分配的激活码帐号数的上限，不能超过下游企业在上下游通讯录中人数上限的两倍 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/batch_share_active_code?provider_access_token=ACCESS_TOKEN

func LICBatchTransfer added in v1.0.23 

func LICBatchTransfer(api *token.Api, transfer []Transfer)

LICBatchTransfer 帐号继承 在企业员工离职或者工作范围的有变更时，允许将其许可帐号继承给其他员工。 调用限制：

转移成员和接收成员属于同一个企业 转移成员的帐号已激活，且在有效期 转移许可的成员为离职成员，或不在服务商应用的可见范围内时，不限制下次转移的时间间隔 转移许可的成员为在职成员且在服务商应用的可见范围内时，转移后30天后才可进行下次转移 接收成员许可不能与转移成员的许可重叠（同时拥有基础帐号或者互通帐号） 单次转移的帐号数限制在1000以内 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/batch_transfer_license?provider_access_token=ACCESS_TOKEN return []TransferResult

func LICGetActiveByUser added in v1.0.23 

func LICGetActiveByUser(api *token.Api, userId string)

LICGetActiveByUser 获取成员的激活详情 查询某个企业成员的激活情况。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_active_info_by_user?provider_access_token=ACCESS_TOKEN return ActiveUser

func LICGetAppInfo added in v1.0.23 

func LICGetAppInfo(api *token.Api, suiteId, appid string)

LICGetAppInfo 获取应用的接口许可状态 服务商可获取某个授权企业的应用接口许可试用期，免费试用期为企业首次安装应用后的90天。 appid (旧的多应用套件中的应用id，新开发者请忽略) 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_app_license_info?provider_access_token=ACCESS_TOKEN

func LICGetAutoActiveStatue added in v1.0.23 

func LICGetAutoActiveStatue(api *token.Api)

LICGetAutoActiveStatue 查询企业的许可自动激活状态 服务商可以调用该接口查询授权企业的许可自动激活状态。

请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_auto_active_status?provider_access_token=ACCESS_TOKEN

func LICSetAutoActiveStatus added in v1.0.23 

func LICSetAutoActiveStatus(api *token.Api, status int)

LICSetAutoActiveStatus 设置企业的许可自动激活状态 设置企业的许可自动激活状态 服务商可以调用该接口设置授权企业的许可自动激活状态。设置为自动激活后，对应授权企业的员工使用服务商应用时，接口许可表现为自动激活。

请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/set_auto_active_status?provider_access_token=ACCESS_TOKEN

func ORAccountList added in v1.0.23 

func ORAccountList(api *token.Api, orderId string, cursor Cursor)

ORAccountList 获取订单中的帐号列表 查询指定订单下的平台能力服务帐号列表。若为购买帐号的订单或者存量企业的版本付费迁移订单，则返回帐号激活码列表；若为续期帐号的订单，则返回续期帐号的成员列表。注意，若是购买帐号的订单，则仅订单支付完成时，系统才会生成帐号，故支付完成之前，该接口不会返回帐号激活码。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/list_order_account?provider_access_token=ACCESS_TOKEN

func ORCancel added in v1.0.23 

func ORCancel(api *token.Api, orderId string)

ORCancel 取消订单 取消接口许可购买和续费订单，只可取消未支付且未失效的订单。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/cancel_order?provider_access_token=ACCESS_TOKEN

func ORCreate added in v1.0.23 

func ORCreate(api *token.Api, order *Order)

ORCreate 下单购买帐号 服务商下单为企业购买新的帐号，可以同时购买基础帐号与互通帐号。下单之后，需要到服务商管理端发起支付，支付完成之后，订单才能生效。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/create_new_order?provider_access_token=ACCESS_TOKEN

func ORGetDetail added in v1.0.23 

func ORGetDetail(api *token.Api, orderId string)

ORGetDetail 获取订单详情 查询某个订单的详情，包括订单的状态、基础帐号个数、互通帐号个数、帐号购买时长等。注意，该接口不返回订单中的帐号激活码列表或者续期的帐号成员列表，请调用获取订单中的帐号列表接口以获取帐号列表。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_order?provider_access_token=ACCESS_TOKEN

func ORGetList added in v1.0.23 

func ORGetList(api *token.Api, cond *ListCond)

ORGetList 获取订单列表 服务商查询自己某段时间内的平台能力服务订单列表 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/list_order?provider_access_token=ACCESS_TOKEN

func ORReCreateJob added in v1.0.23 

func ORReCreateJob(api *token.Api, order *ReOrder)

ORReCreateJob 创建续期任务 在同一个订单里，首次创建任务无须指定jobid，后续指定同一个jobid，表示往同一个订单任务追加续期的成员。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/create_renew_order_job?provider_access_token=ACCESS_TOKEN

func ORSubJob added in v1.0.23 

func ORSubJob(api *token.Api, order *SubOrder)

ORSubJob 提交续期订单 创建续期任务之后，需要调用该接口，以提交订单任务。注意，提交之后，需要到服务商管理端发起支付，支付完成之后，订单才能生效。 请求方式： POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/submit_order_job?provider_access_token=ACCESS_TOKEN

Types

type Account added in v1.0.23 

type Account struct {
	Userid string `json:"userid"`
	Type   int    `json:"type"`
}

type AccountCount added in v1.0.23 

type AccountCount struct {
	BaseCount            int `json:"base_count"`
	ExternalContactCount int `json:"external_contact_count"`
}

type AccountDuration added in v1.0.23 

type AccountDuration struct {
	Months int `json:"months"`
	Days   int `json:"days"`
}

type ActiveCode added in v1.0.23 

type ActiveCode struct {
	ActiveCode string `json:"active_code"`
	Userid     string `json:"userid,omitempty"`
}

type ActiveCodeResult added in v1.0.23 

type ActiveCodeResult struct {
	ActiveCode string `json:"active_code"`
	Userid     string `json:"userid"`
	Errcode    int    `json:"errcode"`
}

type ActiveDetail added in v1.0.23 

type ActiveDetail struct {
	ActiveInfo
	MergeInfo MergeInfo `json:"merge_info"`
}

type ActiveInfo added in v1.0.23 

type ActiveInfo struct {
	ActiveCode string `json:"active_code"`
	Type       int    `json:"type"`
	Status     int    `json:"status"`
	Userid     string `json:"userid"`
	CreateTime int    `json:"create_time"`
	ActiveTime int    `json:"active_time"`
	ExpireTime int    `json:"expire_time"`
}

type ActiveUser added in v1.0.23 

type ActiveUser struct {
	ActiveStatus   int          `json:"active_status"`
	ActiveInfoList []ActiveInfo `json:"active_info_list"`
}

type AdminInfo 

type AdminInfo struct {
	Userid     string `json:"userid"`
	OpenUserid string `json:"open_userid"`
	AuthType   int    `json:"auth_type"`
}

type AdminList 

type AdminList struct {
	Admins []AdminInfo `json:"admin"`
}

func GetAdminList 

func GetAdminList(api *token.Api, authCorpId string, agentId int64) (*AdminList, error)

GetAdminList 获取应用的管理员列表 POST（HTTPS） https://qyapi.weixin.qq.com/cgi-bin/service/get_admin_list?suite_access_token=SUITE_ACCESS_TOKEN

type Agent 

type Agent struct {
	AgentId          int64      `json:"agentid"`
	Name             string     `json:"name"`
	RoundLogoUrl     string     `json:"round_logo_url"`
	SquareLogoUrl    string     `json:"square_logo_url"`
	Appid            int64      `json:"appid"`
	AuthMode         int        `json:"auth_mode,omitempty"`
	IsCustomizedApp  bool       `json:"is_customized_app,omitempty"`
	AuthFromThirdApp bool       `json:"auth_from_thirdapp,omitempty"`
	Privilege        Privilege  `json:"privilege,omitempty"`
	SharedFrom       SharedFrom `json:"shared_from"`
}

type AppLicense added in v1.0.23 

type AppLicense struct {
	LicenseStatus int       `json:"license_status"`
	TrailInfo     TrailInfo `json:"trail_info"`
}

type AuthCorpInfo 

type AuthCorpInfo struct {
	CorpId            string `json:"corpid"`
	CorpName          string `json:"corp_name"`
	CorpType          string `json:"corp_type"`
	CorpSquareLogoUrl string `json:"corp_square_logo_url"`
	CorpUserMax       int    `json:"corp_user_max"`
	CorpFullName      string `json:"corp_full_name"`
	VerifiedEndTime   int    `json:"verified_end_time"`
	SubjectType       int    `json:"subject_type"`
	CorpWxqrcode      string `json:"corp_wxqrcode"`
	CorpScale         string `json:"corp_scale"`
	CorpIndustry      string `json:"corp_industry"`
	CorpSubIndustry   string `json:"corp_sub_industry"`
}

type AuthEvent added in v1.0.16 

type AuthEvent struct {
	AuthCode string `json:"AuthCode" xml:"AuthCode"`
	State    string `json:"State" xml:"State"`
}

AuthEvent 授权通知事件 InfoType = create_auth, change_auth, cancel_auth

type AuthInfo 

type AuthInfo struct {
	Agent []Agent `json:"agent"`
}

type AuthUserInfo 

type AuthUserInfo struct {
	Userid     string `json:"userid"`
	OpenUserid string `json:"open_userid"`
	Name       string `json:"name"`
	Avatar     string `json:"avatar"`
}

type ContactEvent added in v1.0.16 

type ContactEvent struct {
	ContactInfo
}

ContactEvent 成员通知事件 InfoType = change_contact, ChangeType= create_user, update_user,delete_user

type ContactInfo 

type ContactInfo struct {
	UserID         string    `json:"UserID" xml:"UserID"`
	OpenUserID     string    `json:"OpenUserID" xml:"OpenUserID"`
	Name           string    `json:"Name" xml:"Name"`
	Department     []string  `json:"Department" xml:"Department"`
	MainDepartment string    `json:"MainDepartment" xml:"MainDepartment"`
	IsLeaderInDept []string  `json:"IsLeaderInDept" xml:"IsLeaderInDept"`
	DirectLeader   []string  `json:"DirectLeader" xml:"DirectLeader"`
	Mobile         string    `json:"Mobile" xml:"Mobile"`
	Position       string    `json:"Position" xml:"Position"`
	Gender         int       `json:"Gender" xml:"Gender"`
	BizMail        string    `json:"BizMail" xml:"BizMail"`
	Email          string    `json:"Email" xml:"Email"`
	Avatar         string    `json:"Avatar" xml:"Avatar"`
	Alias          string    `json:"Alias" xml:"Alias"`
	Telephone      string    `json:"Telephone" xml:"Telephone"`
	ExtAttr        []ExtAttr `json:"ExtAttr" xml:"ExtAttr"`
}

type Cursor added in v1.0.23 

type Cursor struct {
	Limit  int    `json:"limit"`
	Cursor string `json:"cursor"`
}

type CustomizedAuthUrl 

type CustomizedAuthUrl struct {
	QrcodeUrl string `json:"qrcode_url"`
	ExpiresIn int    `json:"expires_in"`
}

func GetCustomizedAuthUrl 

func GetCustomizedAuthUrl(api *token.Api, state string, templateId []string) (*CustomizedAuthUrl, error)

GetCustomizedAuthUrl 获取带参授权链接 该API用于获取代开发自建应用授权链接，用于生成带参临时二维码。 请求方式：POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/service/get_customized_auth_url?provider_access_token=PROVIDER_ACCESS_TOKEN

type DealerCorpInfo 

type DealerCorpInfo struct {
	CorpId   string `json:"corpid"`
	CorpName string `json:"corp_name"`
}

type DepartmentEvent added in v1.0.16 

type DepartmentEvent struct {
	DepartmentInfo
}

DepartmentEvent 部门通知事件 InfoType = change_contact, ChangeType = create_party, update_party, delete_party

type DepartmentInfo 

type DepartmentInfo struct {
	Id       int64  `json:"Id" xml:"Id"`
	Name     string `json:"Name" xml:"Name"`
	ParentId int64  `json:"ParentId" xml:"ParentId"`
	Order    int    `json:"Order" xml:"Order"`
}

type EventNotify added in v1.0.16 

type EventNotify struct {
	SuiteId    string `json:"SuiteId" xml:"SuiteId"`
	InfoType   string `json:"InfoType" xml:"InfoType"`
	AuthCorpId string `json:"AuthCorpId" xml:"AuthCorpId"`
	ChangeType string `json:"ChangeType" xml:"ChangeType"`
	TimeStamp  int64  `json:"TimeStamp" xml:"TimeStamp"`
}

type ExtAttr 

type ExtAttr struct {
	Name string `json:"Name" xml:"Name"`
	Type int    `json:"Type" xml:"Type"`
}

type InvalidAccount added in v1.0.23 

type InvalidAccount struct {
	Errcode int    `json:"errcode"`
	Errmsg  string `json:"errmsg"`
	Userid  string `json:"userid"`
	Type    int    `json:"type"`
}

type ListCond added in v1.0.23 

type ListCond struct {
	CorpId    string `json:"corpid"`
	StartTime int    `json:"start_time"`
	EndTime   int    `json:"end_time"`
	Cursor
}

type LoginAgent 

type LoginAgent struct {
	Agentid  int `json:"agentid"`
	AuthType int `json:"auth_type"`
}

type LoginAuthInfo 

type LoginAuthInfo struct {
	Department []LoginDepartment `json:"department"`
}

type LoginDepartment 

type LoginDepartment struct {
	Id       int  `json:"id"`
	Writable bool `json:"writable"`
}

type LoginInfo 

type LoginInfo struct {
	Usertype int           `json:"usertype"`
	UserInfo AuthUserInfo  `json:"user_info"`
	CorpInfo AuthCorpInfo  `json:"corp_info"`
	Agent    []LoginAgent  `json:"agent"`
	AuthInfo LoginAuthInfo `json:"auth_info"`
}

func GetLoginInfo 

func GetLoginInfo(api *token.Api, authCode string) (*LoginInfo, error)

GetLoginInfo 获取登录用户信息 [扫码授权登录] 第三方可通过如下接口，获取登录用户的信息。建议用户以返回信息中的corpid及userid为主键匹配用户 授权登录服务商的网站时，使用应用提供商的provider_access_token 请求方式：POST（HTTPS） 请求地址： https://qyapi.weixin.qq.com/cgi-bin/service/get_login_info?access_token=PROVIDER_ACCESS_TOKEN

type MergeInfo added in v1.0.23 

type MergeInfo struct {
	ToActiveCode   string `json:"to_active_code"`
	FromActiveCode string `json:"from_active_code"`
}

type Order added in v1.0.23 

type Order struct {
	CorpId          string          `json:"corpid"`
	BuyerUserId     string          `json:"buyer_userid"`
	AccountCount    AccountCount    `json:"account_count"`
	AccountDuration AccountDuration `json:"account_duration"`
}

type OrderDetail added in v1.0.23 

type OrderDetail struct {
	CorpId          string          `json:"corpid"`
	OrderId         string          `json:"order_id"`
	OrderType       int             `json:"order_type"`
	OrderStatus     int             `json:"order_status"`
	Price           int             `json:"price"`
	CreateTime      int             `json:"create_time"`
	PayTime         int             `json:"pay_time"`
	AccountCount    AccountCount    `json:"account_count"`
	AccountDuration AccountDuration `json:"account_duration"`
}

type OrderInfo added in v1.0.23 

type OrderInfo struct {
	OrderId   string `json:"order_id"`
	OrderType int    `json:"order_type"`
}

type OrderListResult added in v1.0.23 

type OrderListResult struct {
	NextCursor string      `json:"next_cursor"`
	HasMore    int         `json:"has_more"`
	OrderList  []OrderInfo `json:"order_list"`
}

type Permanent 

type Permanent struct {
	access.PermanentAccessToken
	PermanentInfo
}

func GetAuthInfo 

func GetAuthInfo(api *token.Api, authCorpId, permanentCode string) (*Permanent, error)

GetAuthInfo 获取企业授权信息 POST（HTTPS） https://qyapi.weixin.qq.com/cgi-bin/service/get_auth_info?suite_access_token=SUITE_ACCESS_TOKEN

type PermanentInfo added in v1.0.13 

type PermanentInfo struct {
	PermanentCode    string           `json:"permanent_code"`
	DealerCorpInfo   DealerCorpInfo   `json:"dealer_corp_info"`
	AuthCorpInfo     AuthCorpInfo     `json:"auth_corp_info"`
	AuthInfo         AuthInfo         `json:"auth_info"`
	AuthUserInfo     AuthUserInfo     `json:"auth_user_info"`
	RegisterCodeInfo RegisterCodeInfo `json:"register_code_info"`
	State            string           `json:"state"`
}

func (PermanentInfo) AgentId added in v1.0.20 

func (p PermanentInfo) AgentId() string

func (PermanentInfo) IsCustomizedApp added in v1.0.13 

func (p PermanentInfo) IsCustomizedApp() bool

IsCustomizedApp 代开发模版授权，另外接口不返回access_token字段 授权的应用信息，注意是一个数组，但仅旧的多应用套件授权时会返回多个agent，对新的单应用授权，永远只返回一个agent

type PreAuthCode 

type PreAuthCode struct {
	Code      string `json:"pre_auth_code"`
	ExpiresIn int64  `json:"expires_in"`
}

func GetPreAuthCode 

func GetPreAuthCode(api *token.Api) (*PreAuthCode, error)

GetPreAuthCode 获取预授权码

type Privilege 

type Privilege struct {
	Level      int      `json:"level"`
	AllowParty []int    `json:"allow_party"`
	AllowUser  []string `json:"allow_user"`
	AllowTag   []int    `json:"allow_tag"`
	ExtraParty []int    `json:"extra_party"`
	ExtraUser  []string `json:"extra_user"`
	ExtraTag   []int    `json:"extra_tag"`
}

type QRCodeReq 

type QRCodeReq struct {
	SuiteId    string `json:"suite_id"`
	Appid      int    `json:"appid"`
	State      string `json:"state"`
	Style      int    `json:"style"`
	ResultType int    `json:"result_type"`
}

type ReOrder added in v1.0.23 

type ReOrder struct {
	CorpId      string    `json:"corpid"`
	Jobid       string    `json:"jobid"`
	AccountList []Account `json:"account_list"`
}

type ReOrderResult added in v1.0.23 

type ReOrderResult struct {
	Jobid              string           `json:"jobid"`
	InvalidAccountList []InvalidAccount `json:"invalid_account_list"`
}

type RegisterCodeInfo 

type RegisterCodeInfo struct {
	RegisterCode string `json:"register_code"`
	TemplateId   string `json:"template_id"`
	State        string `json:"state"`
}

type ShareActiveCode added in v1.0.23 

type ShareActiveCode struct {
	FromCorpId string       `json:"from_corpid"`
	ToCorpId   string       `json:"to_corpid"`
	ShareList  []ActiveCode `json:"share_list"`
}

type ShareResult added in v1.0.23 

type ShareResult struct {
	ActiveCode string `json:"active_code"`
	Errcode    int    `json:"errcode"`
	Errmsg     string `json:"errmsg"`
}

type SharedFrom 

type SharedFrom struct {
	CorpId    string `json:"corpid"`
	ShareType int    `json:"share_type"`
}

type SubOrder added in v1.0.23 

type SubOrder struct {
	Jobid           string          `json:"jobid"`
	BuyerUserid     string          `json:"buyer_userid"`
	AccountDuration AccountDuration `json:"account_duration"`
}

type SuiteTicketEvent added in v1.0.16 

type SuiteTicketEvent struct {
	SuiteTicket string `json:"SuiteTicket" xml:"SuiteTicket"`
}

SuiteTicketEvent 推送suite_ticket

type TagEvent added in v1.0.16 

type TagEvent struct {
	TagInfo
}

TagEvent 标签通知事件 回调设置在授权应用可见范围内的标签的变更事件。由第三方应用调用接口触发的标签变更事件不回调给该应用本身。 InfoType = change_contact, ChangeType = update_tag

type TagInfo 

type TagInfo struct {
	TagId         int64    `json:"TagId" json:"TagId"`
	AddUserItems  []string `json:"AddUserItems" xml:"AddUserItems"`
	DelUserItems  []string `json:"DelUserItems" xml:"DelUserItems"`
	AddPartyItems []int64  `json:"AddPartyItems" xml:"AddPartyItems"`
	DelPartyItems []int64  `json:"DelPartyItems" xml:"DelPartyItems"`
}

type TrailInfo added in v1.0.23 

type TrailInfo struct {
	StartTime int `json:"start_time"`
	EndTime   int `json:"end_time"`
}

type Transfer added in v1.0.23 

type Transfer struct {
	HandoverUserid string `json:"handover_userid"`
	TakeoverUserid string `json:"takeover_userid"`
}

type TransferResult added in v1.0.23 

type TransferResult struct {
	HandoverUserid string `json:"handover_userid"`
	TakeoverUserid string `json:"takeover_userid"`
	Errcode        int    `json:"errcode"`
}

type UserDetail3rd 

type UserDetail3rd struct {
	Corpid string `json:"corpid"`
	Userid string `json:"userid"`
	Name   string `json:"name"`
	Gender string `json:"gender"`
	Avatar string `json:"avatar"`
	QrCode string `json:"qr_code"`
}

func GetUserDetail3rd 

func GetUserDetail3rd(api *token.Api, ticket string) (*UserDetail3rd, error)

GetUserDetail3rd 获取访问用户敏感信息 请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/auth/getuserdetail3rd?suite_access_token=SUITE_ACCESS_TOKEN

type UserInfo3rd 

type UserInfo3rd struct {
	CorpId     string `json:"corpid"`
	Userid     string `json:"userid"`
	UserTicket string `json:"user_ticket"`
	ExpiresIn  int    `json:"expires_in"`
	OpenUserid string `json:"open_userid"`
}

func GetuserInfo3rd 

func GetuserInfo3rd(api *token.Api, code string) (*UserInfo3rd, error)

GetuserInfo3rd 获取访问用户身份 请求方式：GET（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/auth/getuserinfo3rd?suite_access_token=SUITE_ACCESS_TOKEN&code=CODE

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.