- واجهة برمجة تطبيقات معالجة ملفات PDF
- تحرير ملف PDF باستخدام Python
- تعتيم محتوى PDF باستخدام أوامر cURL
واجهة برمجة تطبيقات معالجة ملفات PDF
Aspose.PDF Cloud SDK for Python هي أداة ممتازة لتحرير ملفات PDF عبر الإنترنت. إنها واجهة برمجة تطبيقات REST قائمة على السحابة توفر ميزات متنوعة للعمل مع مستندات PDF، مثل إنشاء ملفات PDF وتحويلها ومعالجتها. باستخدام مجموعة أدوات التطوير البرمجية هذه، يمكنك بسهولة تحرير المعلومات الحساسة من ملفات PDF عبر الإنترنت دون الحاجة إلى تثبيت أي برنامج إضافي على جهاز الكمبيوتر الخاص بك.
إنه يوفر العديد من الفوائد مقارنة بطرق التحرير التقليدية. على سبيل المثال، ميزة التحرير في واجهة برمجة التطبيقات أسرع وأكثر دقة من التحرير اليدوي. كما تضمن إزالة المعلومات الحساسة بشكل دائم من المستند، مما يمنع الوصول غير المصرح به إلى المعلومات.
الآن الخطوة الأولى هي تثبيت SDK، والذي يتوفر للتنزيل عبر مستودع PIP وGitHub. يرجى تنفيذ الأمر التالي في المحطة الطرفية لإكمال التثبيت.
pip install asposepdfcloud
بيئة تطوير متكاملة لـ PyCharm
إذا كنت تستخدم PyCharm IDE، فيمكنك إضافة SDK مباشرة كاعتمادية في مشروعك.
ملف ->الإعدادات ->المشروع ->مُفسِّر بايثون ->asposepdfcloud

Image 1:- PyCharm settings option.

الصورة 2:- حزمة Aspose.Pdf Cloud Python.
بعد التثبيت، فإن الخطوة الرئيسية التالية هي الحصول على بيانات اعتماد العميل من لوحة التحكم. في حالة عدم وجود حساب لديك، ما عليك سوى التسجيل باستخدام خيار إنشاء حساب جديد.
تحرير ملف PDF باستخدام Python
يرجى اتباع التعليمات الواردة أدناه لتحرير محتوى PDF باستخدام مقتطف كود Python:
- إنشاء مثيل لـ ApiClient عن طريق تمرير بيانات اعتماد العميل كوسائط.
- قم الآن بتهيئة PdfApi أثناء تمرير كائن ApiClient كحجة.
- قم بإنشاء كائن RedactionAnnotation واستدعاء طريقة postpageredactionannotations(..) من PdfApi لإنجاز متطلباتنا.
def redactPDF():
try:
#Client credentials
client_secret = "1c9379bb7d701c26cc87e741a29987bb"
client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"
#initialize PdfApi client instance using client credetials
pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)
# إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
pdf_api = PdfApi(pdf_api_client)
# إدخال ملف PDF
input_file = 'marketing.pdf'
# إنشاء مثيل لفئة RedactAnnotation
redactAnnotation = asposepdfcloud.models.RedactionAnnotation()
redactAnnotation.contents = 'Confidential'
# تعيين تفاصيل اللون لكائن التعليق التوضيحي
redactAnnotation.color = asposepdfcloud.Color(a = 0, r = 66, g = 111, b = 245)
# تعيين تاريخ التعديل للتعليق التوضيحي
redactAnnotation.modified = '01/01/2018 12:00:00.000 AM'
redactAnnotation.id = 1
# تعيين علم التوضيح كعلم افتراضي
redactAnnotation.flags = [asposepdfcloud.models.AnnotationFlags.DEFAULT]
redactAnnotation.name = 'redactName'
# حدد المنطقة المستطيلة للتعليق التوضيحي على الصفحة
redactAnnotation.rect = asposepdfcloud.models.Rectangle(llx = 20, lly = 700, urx = 220, ury = 650 )
redactAnnotation.page_index = 1
# عامل ZIndex للتعليق التوضيحي
redactAnnotation.z_index = 1
# تعيين المحاذاة الرأسية والأفقية كمركز
redactAnnotation.horizontal_alignment = asposepdfcloud.models.HorizontalAlignment.CENTER
redactAnnotation.vertical_alignment = asposepdfcloud.models.HorizontalAlignment.CENTER
# تفاصيل النقطة لتعليق التحرير
redactAnnotation.quad_point = [
asposepdfcloud.models.Point(5, 40),
asposepdfcloud.models.Point(10, 60)
]
# تفاصيل لون تعبئة التعليقات التوضيحية
redactAnnotation.fill_color = asposepdfcloud.Color(a = 10, r = 50, g = 168, b = 182)
# نص تراكبي ليتم طباعته على تعليق التحرير
redactAnnotation.overlay_text = 'Confidential Data'
# كرر حدوث التعليق التوضيحي
redactAnnotation.repeat = True
# تعيين معلومات محاذاة النص على أنها محاذاة إلى اليسار
redactAnnotation.text_alignment = asposepdfcloud.models.HorizontalAlignment.LEFT
# اتصل بواجهة برمجة التطبيقات لإضافة تعليق التحرير إلى الصفحة الأولى من المستند
response = pdf_api.post_page_redaction_annotations(name = input_file, page_number= 1, annotations= [redactAnnotation])
# طباعة رمز الاستجابة في وحدة التحكم
print(response)
# طباعة الرسالة في وحدة التحكم (اختياري)
print('Redaction Annotation successfully added to PDF document !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
تعتيم محتوى PDF باستخدام أوامر cURL
باستخدام الأمر cURL وAspose.PDF Cloud، أصبح تحرير ملفات PDF أسهل من أي وقت مضى. Aspose.PDF Cloud عبارة عن واجهة برمجة تطبيقات RESTful يمكن استخدامها مع لغات برمجة متعددة، بما في ذلك الأمر cURL. يمكنك بسهولة تحرير المعلومات الحساسة من ملفات PDF عن طريق إخفاء النص أو إزالته تمامًا. واجهة برمجة التطبيقات آمنة وموثوقة وقابلة للتطوير، مما يجعلها خيارًا مثاليًا للشركات من جميع الأحجام.
الآن الخطوة الأولى هي تنفيذ الأمر التالي لتوليد accessToken.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
بمجرد حصولنا على رمز الوصول، يرجى تنفيذ الأمر التالي لتحرير المعلومات في مستند PDF في المنطقة المستطيلة المحددة (“LLX”: 20، “LLY”: 700، “URX”: 220، “URY”: 650).بعد العملية الناجحة، يتم حفظ الملف الناتج في التخزين السحابي.
curl -v -X POST "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/redaction?apply=true" \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "[ { \"Color\": { \"A\": 0, \"R\": 158, \"G\": 50, \"B\": 168 }, \"Contents\": \"Confidential\", \"Modified\": \"01/18/2022 12:00:00.000 AM\", \"Id\": \"1\", \"Flags\": [ \"Default\" ], \"Name\": \"Name\", \"Rect\": { \"LLX\": 20, \"LLY\": 700, \"URX\": 220, \"URY\": 650 }, \"PageIndex\": 1, \"ZIndex\": 1, \"HorizontalAlignment\": \"CENTER\", \"VerticalAlignment\": \"CENTER\", \"QuadPoint\": [ { \"X\": 5, \"Y\": 10 } ], \"FillColor\": { \"A\": 10, \"R\": 50, \"G\": 168, \"B\": 182 }, \"BorderColor\": { \"A\": 10, \"R\": 168, \"G\": 50, \"B\": 141 }, \"OverlayText\": \"Sensitive data\", \"Repeat\": true, \"TextAlignment\": \"Left\" }]"
استبدل
{inputPDF}
باسم ملف PDF المتوفر في التخزين السحابي و{accessToken}
برمز الوصول الذي تم إنشاؤه أعلاه.
خاتمة
في الختام، يعد تحرير ملفات PDF مهمة بالغة الأهمية لحماية المعلومات الحساسة من الكشف عنها. سواء اخترت استخدام Python أو الأمر cURL مع Aspose.PDF Cloud، أصبحت العملية أبسط وأكثر كفاءة مع التوافر. لذا، سواء كنت محترفًا قانونيًا أو ممارسًا طبيًا أو محللًا ماليًا، فإن تعلم كيفية تحرير ملفات PDF باستخدام Python يمكن أن يساعدك في حماية معلوماتك السرية والامتثال لقواعد حماية البيانات.
##روابط مفيدة
المقالات الموصى بها
ننصحك بشدة بزيارة المقالات التالية للتعرف على: