حل شرح المستندات والصور لأي نظام أساسي.

GroupDocs.Annotation Cloud API عبارة عن حل مستقل للتعليقات التوضيحية للصور ومستندات النظام الأساسي ، والذي يمكّن المطورين من إضافة ميزة التعليقات التوضيحية في تطبيقهم بأقل جهد ممكن. تدعم واجهة برمجة التطبيقات مجموعة من أنواع التعليقات التوضيحية ، ولكن في هذا المنشور سأركز على التعليق التوضيحي لتنقيح النص لتوضيح كيفية تنقيح نص PDF.

تنقيح النص هي عملية لإزالة المحتوى من مستند بشكل دائم. قبل نشر المستند ، تحتاج إلى إزالة البيانات الحساسة والخاصة من المستند. توفر GroupDocs.Annotation Cloud ، تعليق توضيحي لتنقيح النص لتنقيح النص في منطقة صفحة معينة. يقوم تنقيح النص بتعبئة جزء من النص بمستطيل أسود لإخفاء الكلمة أو العبارة الأساسية.

دعني أقدم لك نظرة عامة سريعة على كيفية تنقيح النص باستخدام GroupDocs.Annotation Cloud مع مجموعة بسيطة من طلبات HTTP. سأستخدم cURL لتنقيح النص في مستند PDF في هذا المثال. لا يقتصر API على تنسيق ملف PDF ، يمكنك التحقق من القائمة الكاملة تنسيقات الملفات المدعومة. كما يوفر حزم SDK لجميع لغات البرمجة الشائعة. يمكنك التحقق من SDKs من مستودع GitHub مع أمثلة العمل واستخدامها مباشرة في تطبيقك.

سنتبع هذه الخطوات للعثور على الصور المكررة:

  • إنشاء رمز الوصول للمصادقة
  • تحميل وثيقة المصدر للتخزين
  • أضف تعليقًا توضيحيًا إلى المستند
  • تنزيل المستند المشروح

إنشاء رمز الوصول

### Retrieve access token JWT(JSON Web Token)
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl --request POST https://api.groupdocs.cloud/connect/token 
--header "Content-Type: application/x-www-form-urlencoded" 
--data "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"

تحميل وثيقة المصدر للتخزين

### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/annotation/storage/file/02_pages.pdf" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
-H "Content-Type: multipart/form-data" 
-F "File=@C:/Temp/02_pages.pdf"

حاشية وثيقة المصدر

يتم استخدام خاصية SvgPath لإضافة تعليق توضيحي لتنقيح النص وإحداثيات خاصية SvgPath تبدأ من أسفل صفحة المستند وتزيد إلى الأعلى.

### Add annotation to source document
curl -X POST "https://api.groupdocs.cloud/v2.0/annotation?filePath=02_pages.pdf" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
-H "Content-Type: application/json" 
-d "[
  {
    "guid": null,
    "documentGuid": 0,
    "text": null,
    "creatorGuid": null,
    "creatorName": "Anonym A.",
    "creatorEmail": null,
 "svgPath":"[{'x':55.2986,'y':613.5769},{'x':260.7985,'y':613.5769},{'x':55.2986,'y':600.5769},{'x':260.7985,'y':600.5769}]",
    "type": 9,
    "access": null,
    "replies": null,
    "createdOn": "0001-01-01T00:00:00",
    "fontColor": null,
    "penColor": 1201033,
    "penWidth": 1,
    "penStyle": 0,
    "backgroundColor": null,
    "fieldText": null,
    "fontFamily": null,
    "fontSize": null,
    "opacity": null,
    "angle": null
  }
]"

تنزيل المستند المشروح

### Download annotated document
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/result?filePath=02_pages.pdf&annotatedPages=false&firstPage=-1&lastPage=-1" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
--output C:/Temp/02_pages_output.pdf

إذا لم تكن قد جربت بالفعل REST API ، فنحن نشجعك على التوجه إلى GroupDocs.Annotation Cloud مع إصدار تجريبي مجاني اليوم. كل ما تحتاجه هو الاشتراك في groupdocs.cloud. بمجرد التسجيل ، يمكنك الاطلاع على الموارد المفيدة التالية من GroupDocs.Annotation Cloud.

تعليق

رأيك مهم جدا بالنسبه لنا. إذا كان لديك أي اقتراحات أو إذا كنت بحاجة إلى أي ميزات معينة تتوقع وجودها في REST API ، فلا تتردد في ترك تعليق لنا أدناه أو في منتدى الدعم.