الانتقال من PDFShift أو ScreenshotOne
تقبل صحيفة الطلبات نفسها التي تقبلها PDFShift v3 و ScreenshotOne. في معظم التكاملات يكفي تغيير سطر واحد: العنوان الأساسي. تسرد هذه الصفحة ما ينبغي التحقق منه غير ذلك.
من PDFShift
- https://api.pdfshift.io/v3/convert/pdf
+ https://api.sahifa.dev/v3/convert/pdf- المصادقة: كما هي. مصادقة أساسية باسم المستخدم
apiومفتاح صحيفة، أو ترويسةX-API-Key. - المعاملات: تعمل
sourceوformatوlandscapeوmarginوheaderوfooterوpagesوzoomوuse_printوdelayوwait_forوcssوjavascriptوauthوcookiesوhttp_headersوraise_for_statusوencodeكما وثّقتها PDFShift.
الفروق
| الخيار | في صحيفة |
|---|---|
filename و webhook و s3_destination | تُرفض بالرمز 400. تُعاد الملفات في الاستجابة فقط ولا تُخزَّن أبدًا. خزّنها بنفسك بعد الاستدعاء. |
header.start_at و footer.start_at | غير مدعومة. |
ترويسة أو تذييل دون margin | يُرفض بالرمز 400؛ أضف هامشًا يتسع للترويسة. |
sandbox | مقبول ويُتجاهَل. |
timeout | حدّه الأقصى 30 ثانية. |
من ScreenshotOne
- https://api.screenshotone.com/take
+ https://api.sahifa.dev/take- المصادقة: المعامل نفسه
access_key، بمفتاح صحيفة. - العناوين الموقّعة: لا يُتحقق من المعامل
signature. أبقِ الاستدعاءات على خادمك. - المعاملات: تعمل خيارات إطار العرض والصفحة الكاملة والعنصر والقص، والصيغ، و
wait_untilوdelayوالوضع الداكن والترويسات وملفات تعريف الارتباط، وخيارات الحجب (block_adsوblock_trackersوblock_cookie_bannersوblock_chatsوhide_selectorsوblock_requestsوblock_resources) كما وثّقتها ScreenshotOne.
الفروق
| الخيار | في صحيفة |
|---|---|
store و storage_* و async و webhook_url | تُرفض بالرمز 400؛ لا يُخزَّن شيء. |
block_banners_by_heuristics | يُرفض بالرمز 400؛ استخدم block_cookie_banners و hide_selectors. |
cache | مقبول ويُتجاهَل: كل طلب يُنشأ من جديد. |
viewport_device والفيديو و GIF و AVIF | غير مدعومة بعد. اضبط viewport_width و viewport_height و device_scale_factor مباشرة. |
timeout | حدّه الأقصى 30 ثانية. |
انتقال آمن
- ضع العنوان الأساسي والمفتاح في الإعدادات، لا في الشيفرة.
- أنشئ عيّنة من مستنداتك الفعلية بالخدمتين وقارن بينهما جنبًا إلى جنب.
- حوّل جزءًا صغيرًا من الحركة، وراقب معدلات الأخطاء والأزمنة، ثم حوّل الباقي.
- احتفظ بالإعدادات القديمة بضعة أسابيع تحسبًا للعودة.
تحتاج مساعدة في مقارنة النتائج لمستنداتك؟ راسلنا على support@sahifa.dev.