title: “واجهة برمجة تطبيقات Aspose.Cells Cloud – الحصول على المفتاح العام (الإصدار 4.0) | وثائق REST” second_title: “مستند” ArticleTitle: “الحصول على المفتاح العام” linktype: “الحصول على المفتاح العام” type: docs url: /get-public-key/ keywords: “Aspose.Cells، المفتاح العام، RSA، واجهة برمجة التطبيقات، السحابة” description: “استرجاع المفتاح العام RSA المستخدم لتشفير البيانات مع Aspose.Cells Cloud. يتضمن عنوان URL للنقطة الطرفية، المعاملات، مثالًا على الطلب والاستجابة، أكواد الحالة، وأمثلة على استخدام SDK.” weight: 100
تسترجع هذه الواجهة المفتاح العام من خوارزمية التشفير غير المتماثل.
ملخص موجز: استخدم واجهة برمجة تطبيقات Aspose.Cells للحصول على المفتاح العام للحصول على المفتاح العام RSA (2048-بت) المطلوب لتشفير البيانات عند العمل مع ملفات إكسل في السحابة. يُعيد عنوان URL المفتاح بصيغة JSON، ويُحمي باستخدام OAuth 2.0.
واجهة برمجة تطبيقات الحصول على المفتاح العام
المتطلبات المسبقة:
احصل على رمز وصول صالح لـ OAuth 2.0 يشمل النطاق Cells.Read قبل استدعاء هذه النقطة الطرفية.
واجهة برمجة التطبيقات على الويب
GET https://api.aspose.cloud/v4.0/cells/publickey
مثال على الطلب (cURL)
curl -X GET "https://api.aspose.cloud/v4.0/cells/publickey" \
-H "Authorization: Bearer {access_token}" \
-H "Accept: application/json"
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب:
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| Authorization | نص | الرأس | رمزBearer لمصادقة OAuth2 (مطلوب). |
| Accept | نص | الرأس | تنسيق الاستجابة المرغوب، مثل application/json (اختياري، والافتراضي هو JSON). |
الاستجابة
{
"Code": 200,
"Status": "OK",
"CellsCloudPublicKey": {
"PublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr...",
"Algorithm": "RSA",
"KeySize": 2048
}
}
أكواد حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | OK | تم تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة برمجة تطبيقات الحصول على المفتاح العام باستخدام حزم تطوير البرامج (SDKs)
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا، مما يمكّنك من إجراء تفاعلات REST مباشرة من متصفح الويب الخاص بك.
استخدام حزم تطوير برامج Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. تُدار التفاصيل الأساسية بواسطة SDK، مما يسمح لك بتنفيذ الحصول على المفتاح العام للخلايا برمز موجز جدًا.
يرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير برامج Aspose.Cells Cloud.
فيما يلي أمثلة ملموسة لأكثر اللغات استخدامًا: