You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Before we will get our **app Key** and **app SID**, let’s find out: what is it and what are they for?
116
+
## **Get Your Client secret and Client id**
117
+
Before we will get our **Client secret** and **Client id**, let’s find out: what is it and what are they for?
118
118
119
-
Simply put, **app Key** is a login and **app SID** is a password. You can create more than one app and each one will have it’s own **app Key** and **app SID**. You can use these apps within your services. Using the [Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/#/) helps you to filter the statistics of your applications in [**My Usage** section](https://dashboard.aspose.cloud/#/usage).
119
+
Simply put, **Client id** is a login and **Client secret** is a password. You can create more than one app and each one will have it’s own **Client secret** and **Client id**. You can use these apps within your services. Using the [Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/) helps you to filter the statistics of your applications in [**My Usage** section](https://dashboard.aspose.cloud/billing/api-usage).
120
120
121
-
Here, you see the example of the apps’ statistics. In the APP column, you can see from which application was a request, also, there are details, size and sender’s IP address of a request.
121
+
Here, you see the example of the apps’ statistics. In the Application column, you can see from which application was a request, also, there are details, status, and sender’s IP address of a request.
122
122
123
123

124
124
125
-
**App Key** and **app SID** are used to get the temporary **JWT token**, which provides access to the API methods of Aspose.Email Cloud. These tokens can be seen in curl requests generated in the [Swagger UI](https://apireference.aspose.cloud/email/).
125
+
**Client secret** and **Client id** are used to get the temporary **JWT token**, which provides access to the API methods of Aspose.Email Cloud. These tokens can be seen in curl requests generated in the [Swagger UI](https://apireference.aspose.cloud/email/).
126
126
127
127
{{% alert color="primary" %}}
128
128
Here you can see a screenshot of the Curl with JWT token:
129
129

130
130
{{% /alert %}}
131
131
132
-
Our SDKs do not require you to receive these tokens again and again as they become obsolete. Instead, the **EmailCloud** class stores **app Key** and **app SID** in itself and receive a token by itself. If the token is out of date, Aspose.Email SDKs automatically receive a new one.
132
+
Our SDKs do not require you to receive these tokens again and again as they become obsolete. Instead, the **EmailCloud** class stores **Client secret** and **Client id** in itself and receive a token by itself. If the token is out of date, Aspose.Email SDKs automatically receive a new one.
133
133
134
-
To get your **app Key** and **app SID** follow these steps:
134
+
To get your **Client secret** and **Client id** follow these steps:
135
135
136
-
1. Open the link of [Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/#/)
136
+
1. Open the link of [Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/)
137
137
1. Sign in or sign up
138
-
1. Open [link](https://dashboard.aspose.cloud/#/apps)
138
+
1. Open [link](https://dashboard.aspose.cloud/applications)
139
139
1. Now you can create a new app or use First App, which is already created for you.
140
-
1. Get **App SID** and **App Key** for your application to use them in SDK (you can also use them in our [Swagger UI](https://apireference.aspose.cloud/email/))
140
+
1. Get **Client id** and **Client secret** for your application to use them in SDK (you can also use them in our [Swagger UI](https://apireference.aspose.cloud/email/))
141
141
142
-
[Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/#/) is a powerful tool where you can control your apps, storages and files.
142
+
[Aspose.Cloud Dashboard](https://dashboard.aspose.cloud/) is a powerful tool where you can control your apps, storages and files.
143
143
144
144
{{% alert color="primary" %}}
145
145
146
146
For example, you can:
147
147
148
-
-**See all files** uploaded to the Storage [here](https://dashboard.aspose.cloud/#/files).
149
-
-**Create** new storage [here](https://dashboard.aspose.cloud/#/storages).
150
-
-**Analyze** API usage [here](https://dashboard.aspose.cloud/#/usage).
148
+
-**See all files** uploaded to the Storage [here](https://dashboard.aspose.cloud/files).
149
+
-**Create** new storage [here](https://dashboard.aspose.cloud/storages).
150
+
-**Analyze** API usage [here](https://dashboard.aspose.cloud/billing/api-usage).
151
151
152
152
{{% /alert %}}
153
153
154
154
155
155
## **Set up EmailCloud Object**
156
-
It is always convenient when everything is in one place. In our case, one of the main classes that will help us in development - [**EmailCloud**](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet/blob/master/docs/README.md).
156
+
It is always convenient when everything is in one place. In our case, one of the main classes that will help us in development - **EmailCloud**.
157
157
158
-
All API methods are available in one [**EmailCloud**](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet/blob/master/docs/README.md) class. To initialize EmailCloud object we need to pass into it 2 required parameters: **App Key** and **App SID** (which are strings).
158
+
All API methods are available in one **EmailCloud** class. To initialize EmailCloud object we need to pass into it 2 required parameters: **Client secret** and **Client id** (which are strings).
159
159
160
160
So, what are we waiting for, let's create an instance of it:
161
161
@@ -166,14 +166,14 @@ So, what are we waiting for, let's create an instance of it:
166
166
{{< tab tabNum="1" >}}
167
167
168
168
```csharp
169
-
usingAspose.Email.Cloud.Sdk.Api; //EmailApi class is here
169
+
usingAspose.Email.Cloud.Sdk.Api; //EmailCloud class is here
170
170
usingAspose.Email.Cloud.Sdk.Model; //REST API models are here
EmailCloud api =newEmailCloud("Your App Key", "Your App SID");
190
+
EmailCloud api =newEmailCloud("Your Client secret", "Your Client id");
191
191
```
192
192
193
193
{{< /tab >}}
@@ -199,7 +199,7 @@ from AsposeEmailCloudSdk import api, models
199
199
200
200
...
201
201
202
-
api = api.EmailCloud("app_key", "app_sid")
202
+
api = api.EmailCloud("client_secret", "client_id")
203
203
```
204
204
205
205
{{< /tab >}}
@@ -212,7 +212,7 @@ include AsposeEmailCloud
212
212
213
213
...
214
214
215
-
@api=EmailCloud.new('appKey', 'appSid')
215
+
@api=EmailCloud.new('client_secret', 'client_id')
216
216
```
217
217
218
218
{{< /tab >}}
@@ -224,7 +224,7 @@ import * as email from "@asposecloud/aspose-email-cloud";
224
224
225
225
...
226
226
227
-
var api =newemail.EmailCloud('appSid', 'appKey');
227
+
var api =newemail.EmailCloud('clientId', 'clientSecret');
228
228
```
229
229
230
230
{{< /tab >}}
@@ -240,8 +240,8 @@ use Aspose\Email\Model;
240
240
241
241
$configuration = new Configuration();
242
242
$configuration
243
-
->setAppKey("appKey")
244
-
->setAppSid("appSid");
243
+
->setClientSecret("clientSecret")
244
+
->setClientId("clientId");
245
245
246
246
$api = new EmailCloud($configuration);
247
247
```
@@ -250,16 +250,16 @@ $api = new EmailCloud($configuration);
250
250
251
251
{{< /tabs >}}
252
252
253
-
Our SDK automatically gets API token using your **AppKey** and **AppSid**. Also, it automatically gets a new token, if previous one is expired.
253
+
Our SDK automatically gets API token using your **clientSecret** and **ClientId**. Also, it automatically gets a new token, if previous one is expired.
254
254
255
255
## **Check Everything Works**
256
256
After setting up Aspose.Email Cloud API SDK, it's time to start using it. The API has numerous functions for working with email messages, calendars, contacts, etc.. Also, the API includes AI functions such as the [Business Card Recognition API](/email/business-cards-recognition-api/) and [Name API](/email/working-with-name-api/). These features will facilitate and speed up the development of your application.
257
257
258
258
Let’s call some SDK methods to see that everything set up properly. For example, you can easily convert an **EML** file to **MSG** format with our API.
259
259
260
-
[EmailApi](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet/blob/master/docs/EmailApi.md) object has a function to convert email messages, it’s called [*ConvertAsync*](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet/blob/master/docs/EmailApi.md#ConvertAsync) which converts email document to the specified format and returns as the file.
260
+
[EmailApi](/email/reference-email-api/) object has a function to convert email messages, it’s called [*Convert*](/email/reference-email-api/#convert) which converts email document to the specified format and returns as the file.
261
261
262
-
This function requires only one parameter — [*ConvertEmailRequest*](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet/blob/master/Model/EmailConvertRequest.cs), which requests a model for conversion. To create a request you need to pass **3 parameters**:
262
+
This function requires only one parameter — [*EmailConvertRequest*](/email/reference-model-email-convert-request/), which requests a model for conversion. To create a request you need to pass **3 parameters**:
263
263
- toFormat - a **file format** you want to convert to (Enum: Eml, Msg, MsgUnicode, Mhtml, Html).
264
264
- fromFormat - a file format you want to convert from.
265
265
- file - a **file to upload** for the further converting.
0 commit comments