المصادقة

الميزات الرئيسية

• Secure, token-based access that can be revoked at any time.
• Support for both machine-to-machine and user-driven scenarios.
• Granular scopes that let you limit what a token can do.

كيفية الاستخدام

إنشاء تطبيق

• اذهب إلى لوحة التحكم
• بعد تسجيل الدخول، انقر على عنصر القائمة **التطبيقات** في شريط الملاحة الأيسر.
• اضغط على **Create New Application** لفتح نموذج إنشاء التطبيق.
• في قسم *تفاصيل التطبيق*، أدخل اسمًا وصفيًا ووصفًا قصيرًا لتطبيقك.
• انقر على زر **Save** لحفظ التطبيق الجديد.
• في قائمة التطبيقات، ابحث عن التطبيق الذي أنشأته للتو وانقر على اسمه.
• في لوحة *بيانات اعتماد العميل* ستظهر لك **معرف العميل (Client ID)** و**سر العميل (Client Secret)** - احفظ هذه القيم بأمان؛ ستحتاجها للحصول على رمز وصول.

الحصول على رمز وصول

• أرسل طلبًا إلى نقطة النهاية Authenticator
  https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
• بعد التنفيذ ستحصل على الرمز، يرجى حفظه للاستخدام لاحقًا

استخدام نقاط النهاية

• اختر واجهة برمجة التطبيقات التي تريد استدعاؤها. في هذا المثال نوضح خدمة التحويل، التي تحول ملفات الجداول إلى صيغة PDF.
• أرسل طلبًا يتضمن الملفات ورمز الوصول API التحويل

  curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
• ستستجيب الخدمة برابط تنزيل لملف PDF المُنشأ، في هذا المثال هو:

  { "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
• أرسل طلبًا يتضمن اسم الملف واسم المجلد إلى API التحميل

  curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
• ستستلم الملف ويمكنك إما استخدامه أو تمريره إلى الخطوة التالية في سير عملك.