Struct DingTalk

pub struct DingTalk {
    pub appid: String,
    pub app_secret: String,
    pub client: Client,
    pub rdb: Arc<Pool>,
}

Fields

appid: String

app_secret: String

client: Client

rdb: Arc<Pool>

Implementations

impl DingTalk

pub async fn get_contact_userinfo( &self, union_id: String, ) -> Result<UserInfo, Box<dyn Error>>

Get the user info of the given union ID.

Documents

Arguments

• union_id - The union ID of the DingTalk user.

Returns

A Result containing the user info if successful, otherwise an error string.

impl DingTalk

pub fn get_redirect_url( &self, redirect_uri: String, state: Option<String>, ) -> String

Generate the redirect URL for DingTalk authorization.

Documents

Arguments

• redirect_uri - The redirect URI after authorization.
• state - An optional state string, which is used to prevent CSRF attacks.

Returns

The redirect URL as a string.

pub async fn set_app_access_token( &self, code: String, ) -> Result<String, Box<dyn Error>>

Obtain the access token for the application.

This asynchronous function sends a POST request to the DingTalk API to obtain the access token for the application. The request includes the authorization code in the query parameters for authentication.

Documents

Arguments

• code - The authorization code to obtain the access token.

Returns

Returns a Result containing the access token as a string if the request is successful, or an error if the request fails or if the response status is not successful.

Errors

Returns an error if the response status is not successful, or if the request fails.

pub async fn get_app_access_token(&self) -> Result<String, Box<dyn Error>>

Get the access token for the application.

The access token is stored in Redis by calling [set_app_access_token].

Returns

A Result containing the access token as a string if the access token exists, otherwise an error string.

impl DingTalk

pub fn set_corp_id(&self, corp_id: String) -> OrgApp

Creates a new OrgApp instance with the given corporate ID and configuration.

This method creates a new instance of OrgApp with the given corporate ID and the same configuration as the current DingTalk instance. This is useful for accessing the DingTalk API of a specific organization.

Arguments

• corp_id - The corporate ID of the organization to create the OrgApp for.

Returns

A new OrgApp instance with the given corporate ID and configuration.

impl DingTalk

pub fn new(appid: String, app_secret: String) -> Self

Creates a new instance of DingTalk.

Arguments

• appid - The app ID issued by DingTalk.
• app_secret - The app secret issued by DingTalk.