dingding

Documentation

Overview

服务商获取第三方应用授权企业的access_token

查询用户详情

获取企业token

Index

• Constants
• func GetUserinfo(access_token string, getuserinfobody GetUserinfoBody)
• func HttpGet(url string) (str string)
• func HttpPost(url string, body_str interface{}) (str string)
• type AerviceActivateAuiteStruct
• type AerviceActivateAuiteStructReturn
  • func AerviceActivateAuite(suite_access_token string, ...) (AerviceActivateAuiteStructReturn AerviceActivateAuiteStructReturn)
• type CorpconversationRecallStruct
• type CorpconversationRecallStructReturn
  • func CorpconversationRecall(access_token string, CorpconversationRecallStruct CorpconversationRecallStruct) (CorpconversationRecallStructReturn CorpconversationRecallStructReturn)
• type GetAuthStruct
  • func Auth(GetAuth GetAuthStruct) (GetAuths GetAuthStruct)
• type GetCorpTokenParameterStruct
• type GetCorpTokenParameterStructReturn
  • func GetCorpTokenParameter(getCorpTokenParameter GetCorpTokenParameterStruct) (getCorpTokenParameterReturn GetCorpTokenParameterStructReturn)
• type GetJsapiTicketStructReturn
  • func GetJsapiTicket(access_token string) (GetJsapiTicketReturn GetJsapiTicketStructReturn)
• type GetSsoGetTokenStructReturn
  • func GetSsoGettoken(corpid string, corpsecret string) (GetSsoGettokenReturn GetSsoGetTokenStructReturn)
• type GetTokenStructReturn
  • func GetToken(appkey string, appsecret string) (gettokenReturn GetTokenStructReturn)
• type GetUserinfoBody
• type JsapiTicketReturnReturn
  • func JsapiTicket(JsapiTicketStruct JsapiTicketStruct) (JsapiTicketReturn JsapiTicketReturnReturn)
• type JsapiTicketStruct
• type UserAccessTokenStruct
• type UserAccessTokenStructReturn
  • func UserAccessToken(UserAccessTokenStruct UserAccessTokenStruct) (UserAccessTokenStructReturn UserAccessTokenStructReturn)

Constants

const AerviceActivateAuiteUrl string = "https://oapi.dingtalk.com/service/activate_suite" //激活应用

const AuthUrl string = "https://login.dingtalk.com/oauth2/auth" //获取登录用户的访问凭证

const CorpconversationRecallUrl string = "https://oapi.dingtalk.com/topapi/message/corpconversation/recall" //工作消息撤回

const GetCorpTokenUrl string = "https://oapi.dingtalk.com/service/get_corp_token" //服务商获取第三方应用授权企业的access_token

const GetJsapiTicketUrl string = "https://oapi.dingtalk.com/get_jsapi_ticket" //获取jsapi_ticket

const GetSsoGettokenUrl string = "https://oapi.dingtalk.com/sso/gettoken" //获取微应用后台免登的access_token

const GetTokenUrl string = "https://oapi.dingtalk.com/gettoken" //获取企业内部的access_token

const GetUserUrl string = "https://oapi.dingtalk.com/topapi/v2/user/get" //获取用户信息接口

const JsapiTicketUrl string = "https://api.dingtalk.com/v1.0/oauth2/jsapiTickets" //创建jsapi_ticket

const UserAccessTokenUrl string = "https://api.dingtalk.com/v1.0/oauth2/userAccessToken" //获取用户token

Functions

func GetUserinfo

func GetUserinfo(access_token string, getuserinfobody GetUserinfoBody)

func HttpGet

func HttpGet(url string) (str string)

get请求

func HttpPost

func HttpPost(url string, body_str interface{}) (str string)

Types

type AerviceActivateAuiteStruct

type AerviceActivateAuiteStruct struct {
	SuiteKey      string `json:"suite_key"`      //第三方应用的SuiteKey(必填)
	AuthCorpid    string `json:"auth_corpid"`    //授权企业的CorpId。(必填)
	PermanentCode string `json:"permanent_code"` //授权企业的永久授权码。（必填）
}

激活应用参数

type AerviceActivateAuiteStructReturn

type AerviceActivateAuiteStructReturn struct {
	Errmsg  string `json:"errmsg"`  //返回码描述。
	Errcode string `json:"errcode"` //返回码
}

激活应用返回

func AerviceActivateAuite

func AerviceActivateAuite(suite_access_token string, AerviceActivateAuiteStruct AerviceActivateAuiteStruct) (AerviceActivateAuiteStructReturn AerviceActivateAuiteStructReturn)

激活应用 参数说明 suite_access_token:第三方应用的suite_access_token，可调用服务商获取第三方应用授权企业的access_token接口获取。 Body参数(必填)

type CorpconversationRecallStruct

type CorpconversationRecallStruct struct {
	AgentId   string `json:"agent_id"`    //发送消息时使用的微应用的ID。（必填）
	MsgTaskId string `json:"msg_task_id"` //发送消息时钉钉返回的任务ID。（必填）
}

工作消息撤回参数

type CorpconversationRecallStructReturn

type CorpconversationRecallStructReturn struct {
	Errmsg  string `json:"errmsg"`  //返回码描述。
	Errcode int    `json:"errcode"` //返回码。
}

工作消息撤回返回

func CorpconversationRecall

func CorpconversationRecall(access_token string, CorpconversationRecallStruct CorpconversationRecallStruct) (CorpconversationRecallStructReturn CorpconversationRecallStructReturn)

工作通知撤回

type GetAuthStruct

type GetAuthStruct struct {
	RedirectUri     string `json:"redirect_uri"`    //授权通过/拒绝后回调地址。(必填)
	ResponseType    string `json:"response_type"`   //固定值为code。授权通过后返回authCode。(必填)
	ClientId        string `json:"client_id"`       //步骤一中创建的应用详情中获取,企业内部应用：client_id为应用的AppKey。企业内部应用：client_id为应用的AppKey。(必填)
	Scope           string `json:"scope"`           //授权范围，授权页面显示的授权信息以应用注册时配置的为准。(必填)
	State           string `json:"state"`           //跟随authCode原样返回（选填）
	Prompt          string `json:"prompt"`          //值为consent时，会进入授权确认页（必填）
	OrgType         string `json:"org_type"`        //控制输出特定类型的组织列表，org_type=management 表示只输出有管理权限的组织（选填）
	CorpId          string `json:"corpId"`          //用于指定用户需要选择的组织（选填）
	ExclusiveLogin  string `json:"exclusiveLogin"`  //true表示专属帐号登录，展示组织代码输入页。（选填）
	ExclusiveCorpId string `json:"exclusiveCorpId"` //开启了专属帐号功能的组织corpId。（选填）
}

获取登录用户的访问凭证参数

func Auth

func Auth(GetAuth GetAuthStruct) (GetAuths GetAuthStruct)

type GetCorpTokenParameterStruct

type GetCorpTokenParameterStruct struct {
	AccessKey   string `json:"accessKey"`   //定制应用的CustomKey或者第三方企业应用的SuiteKey（必填）
	Timestamp   string `json:"timestamp"`   //时间戳
	SuiteTicket string `json:"suiteTicket"` //钉钉推送的suiteTicket。
	Signature   string `json:"signature"`   //签名，签名计算方式请参考第三方访问接口的签名计算方法。
	AuthCorpid  string `json:"auth_corpid"` //授权企业的CorpId。
}

服务商获取第三方应用授权企业的access_token传递结构体

type GetCorpTokenParameterStructReturn

type GetCorpTokenParameterStructReturn struct {
	ExpiresIn   string `json:"expires_in"`   //授权企业的access_token超时时间，单位秒。
	AccessToken string `json:"access_token"` //授权企业的access_token。
	Errmsg      string `json:"errmsg"`       //返回码的描述。
	Errcode     string `json:"errcode"`      //返回码。
}

服务商获取第三方应用授权企业的access_token返回数据

func GetCorpTokenParameter

func GetCorpTokenParameter(getCorpTokenParameter GetCorpTokenParameterStruct) (getCorpTokenParameterReturn GetCorpTokenParameterStructReturn)

type GetJsapiTicketStructReturn

type GetJsapiTicketStructReturn struct {
	ExpiresIn string `json:"expires_in"` //jsapi_ticket超时时间。
	Ticket    string `json:"ticket"`     //生成的临时jsapi_ticket。
	Errmsg    string `json:"errmsg"`     //返回码描述
	Errcode   string `json:"errcode"`    //返回码
}

获取jsapi_ticket返回

func GetJsapiTicket

func GetJsapiTicket(access_token string) (GetJsapiTicketReturn GetJsapiTicketStructReturn)

获取jsapi_ticket

*参数描述： *access_token：调用服务端API的应用凭证。

type GetSsoGetTokenStructReturn

type GetSsoGetTokenStructReturn struct {
	AccessToken string `json:"access_token"` //获取到的凭证。
	Errmsg      string `json:"errmsg"`       //错误信息
	Errcode     string `json:"errcode"`      //错误码
}

获取微应用后台免登的access_token

func GetSsoGettoken

func GetSsoGettoken(corpid string, corpsecret string) (GetSsoGettokenReturn GetSsoGetTokenStructReturn)

获取微应用后台免登的access_token

*参数描述： *corpid：企业的corpid。（必填） *corpsecret：可以在开发者后台的基本信息 > 开发信息（旧版）页面获取微应用管理后台SSOSecret。（必填）

type GetTokenStructReturn

type GetTokenStructReturn struct {
	AccessToken string `json:"access_token"` //生成的access_token。
	ExpiresIn   int    `json:"expires_in"`   //access_token的过期时间，单位秒。
	Errmsg      string `json:"errmsg"`       //返回码描述。
	Errcode     int    `json:"errcode"`      //返回码
}

获取企业内部token返回数据结构体

func GetToken

func GetToken(appkey string, appsecret string) (gettokenReturn GetTokenStructReturn)

*参数说明： *appkey：应用唯一标识key（必填）示例参数：dingeqqpkv3xxxx *appsecret：应用的密钥。AppKey和AppSecret可在钉钉开发者后台的应用详情页面获取。（必填）示例参数：GT-lsu-taDAsTsxxxx *返回参数：GettokenReturn结构体

type GetUserinfoBody

type GetUserinfoBody struct {
	Userid   string `json:"userid"`   //用户id
	Language string `json:"language"` //通讯录语言
}

/ 查询用户详情传递报文数据

type JsapiTicketReturnReturn

type JsapiTicketReturnReturn struct {
	JsapiTicket string `json:"jsapiTicket"` //返回的jsapi_ticket。
	ExpireIn    string `json:"expireln"`    //jsapi_ticket超时时间。
}

创建jsapi_ticket返回

func JsapiTicket

func JsapiTicket(JsapiTicketStruct JsapiTicketStruct) (JsapiTicketReturn JsapiTicketReturnReturn)

创建jsapi_ticket

type JsapiTicketStruct

type JsapiTicketStruct struct {
	XAcsDingtalkAccessToken string `json:"x-acs-dingtalk-access-token"` //调用服务端API的应用凭证。
}

创建jsapi_ticket参数

type UserAccessTokenStruct

type UserAccessTokenStruct struct {
	ClientId     string `json:"clientId"`     //应用id。(必填)
	ClientSecret string `json:"clientSecret"` //应用密钥。（选填）
	Code         string `json:"code"`         //OAuth 2.0 临时授权码（选填）
	RefreshToken string `json:"refreshToken"` //OAuth2.0刷新令牌，从返回结果里面获取。（选填）
	GrantType    string `json:"grantType"`    //(选填)
}

获取登录用户的token

type UserAccessTokenStructReturn

type UserAccessTokenStructReturn struct {
	AccessToken  string `json:"accessToken"`  //生成的accessToken
	RefreshToken string `json:"refreshToken"` //生成的refresh_token。可以使用此刷新token，定期的获取用户的accessToken
	ExpireIn     string `json:"expireIn"`     //超时时间，单位秒
	CorpId       string `json:"corpId"`       //所选企业corpId
}

获取登录用户的token返回

func UserAccessToken

func UserAccessToken(UserAccessTokenStruct UserAccessTokenStruct) (UserAccessTokenStructReturn UserAccessTokenStructReturn)

获取用户token