JWT logo preview

JSON Web Token (JWT) 是一个用 JSON 编码的开放性、行业标准 RFC 7519 方法的声明(s)的表示形式，可以在两个当事方之间转移。该声明由令牌的发行方进行数字签名，接收此令牌的当事方可以在以后使用此数字签名来证明声明的所有权。

在 Aspose，我们同样重视数据完整性和身份验证，就像我们关注新功能的构建一样。因此，所有 Aspose.Cloud API 仅对授权人员开放。此外，我们存储在云存储中的文件只能通过我们用于上传的账户访问。因此，为了与 Aspose.Cloud API 交互，您需要首先获得您的特定客户端 ID 和客户端密钥。

  • 请访问 Aspose.Cloud dashboard 网站。您将被重定向到 Aspose 单一登录身份验证服务。
  • 如果您有 GitHub 或 Google 帐户，请直接注册。否则，请点击 创建新帐户 按钮并提供所需信息。

恭喜！我们已经成功创建了一个账户，并可以访问 Aspose Cloud Dashboard。

现在登录到仪表板，从仪表板中展开应用程序部分，然后向下滚动到客户端凭证部分，以查看客户端 ID 和客户端密钥详细信息。

应用程序菜单预览

图像 1 :- 应用程序菜单预览

使用客户端凭证与 SDK

您可以使用 Aspose Cloud SDKs 来调用 Aspose REST API，因为 SDK 处理认证、发起请求和处理响应的低级细节，让您可以专注于编写特定于项目的代码。为不同的编程语言和移动平台提供了 SDK。因此，为了使用 SDK 访问 Cloud API，您需要使用您的客户端 ID 和客户端密钥。

C# .NET

// 对于完整的示例和数据文件，请访问 https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

using System;
using System.IO;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

namespace Aspose.Words.Cloud.Examples.CSharp
{
	public class ConvertPDFDocumentToWord
	{
		public static void Run()
		{
			WordsApi wordsApi = new WordsApi(Constants.AppKey, Constants.AppSID);

			try
			{
				string fileName = "test_multi_pages.pdf";
				string format = "docx";
				string destName = "Out_test_multi_pages.docx";

				// 上传原始文档到云存储
				wordsApi.UploadFile(new UploadFileRequest(File.Open("..\\..\\..\\Resources\\" + fileName, FileMode.Open), fileName, Constants.MYStorage));

				SaveAsRequest request = new SaveAsRequest(fileName, new SaveOptionsData() { SaveFormat = format, FileName = destName }, null, Constants.MYStorage, null, null, null);
				SaveResponse result = wordsApi.SaveAs(request);

			}
			catch (Exception e)
			{
				Console.WriteLine(e.ToString());
			}
		}
	}
}

API References section

我们需要使用客户端 ID 和客户端密钥访问 Cloud API References 在 swagger 视图中。因此，如果您需要通过 swagger 视图访问 Aspose.Words Cloud，请单击授权按钮，并输入您从 Aspose.Cloud dashboard 获得的个性化客户端 ID 和客户端密钥详细信息。

API Reference preview

Image 2 :- API 参考凭证屏幕预览

JWT 令牌生成

为了通过命令提示符使用云 API，您需要使用客户端 ID 和客户端密钥生成 JWT 令牌。

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxxxx-1c8e-4ea4-a948-3857547232fa&client_secret=xxxxxxx3e329cdf5694cc96a" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

JWT 令牌在控制台中显示。现在我们可以使用相同的令牌来访问 Aspose.Cloud APIs 并实现所需的功能。以下示例使用 Aspose.Words Cloud API 将输入 marketing.pdf 文件转换为 MS Word (.docx)。

curl -v "https://api.aspose.cloud/v4.0/words/marketing.pdf/saveAs" \
-X PUT \
-d "{'SaveFormat':'docx', 'FileName': 'Converted.docx'}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <JWT Access Token>"

结论

Cloud API 是可靠且便捷的方式，可以快速实现您所需的功能。您不需要下载或安装任何软件。此外，授权层提供了额外的安全感，您的私人数据仅对您可访问。请尝试使用我们的 Cloud APIs，如果您遇到任何问题，请随时在 Product support forums 上发布您的查询。