قائمة التوثيق

البداية

مرجع الواجهة البرمجية

أدلة

الثقة والدعم

الحدود والمهل

الحدود التي تنطبق على كل طلب، وسلوك الخادم في أوقات الانشغال.

لكل طلب

الحدالقيمةملاحظات
جسم الطلب10 ميغابايتشيفرة HTML والصور المضمنة والمعاملات مجتمعة. الطلبات الأكبر تتلقى 413.
زمن الإنشاء30 ثانيةيشمل تحميل الصفحة ومواردها. يمكن للمعامل timeout خفضه لا رفعه.
delay في PDF10,000 مللي ثانيةبالمللي ثانية، كما في PDFShift.
delay في لقطات الشاشة30 ثانيةبالثواني، كما في ScreenshotOne. ويُحتسب ضمن الثلاثين ثانية.
إطار العرضحتى 10,000 بكسلللعرض والارتفاع؛ و device_scale_factor حتى 4.
عدد صفحات PDFلا حد ثابتيحدّه زمن الإنشاء. تُنشأ مئات الصفحات البسيطة ضمنه بسهولة.

التزامن وقائمة الانتظار

يُنشئ الخادم عدة مستندات في الوقت نفسه. والطلبات الزائدة عن ذلك تنتظر في قائمة قصيرة وتُعالَج بالترتيب، فتُستوعَب موجة الطلبات بدلًا من رفضها. وإذا امتلأت القائمة نفسها تكون الاستجابة 429: انتظر لحظة وأعد المحاولة.

في المهام الدفعية، أرسل بضعة طلبات بالتوازي (أربعة بداية جيدة) بدلًا من المئات دفعة واحدة. هكذا يبقى كل طلب سريعًا وتتجنب استجابات 429.

أزمنة الإنشاء المعتادة

مقيسة في جدة، على الخادم نفسه، دون زمن الشبكة:

المهمةالزمن
ملف PDF عربي من صفحة واحدة من HTMLنحو 0.1 إلى 0.4 ثانية
لقطة شاشة لصفحة ثابتةنحو 0.3 إلى 1 ثانية
لقطة شاشة لموقع إخباري مع block_cookie_bannersنحو 4 إلى 9 ثوانٍ
صفحة مبنية بجافاسكربت مع wait_until=networkidleنحو 10 إلى 20 ثانية

الصفحات التي تُحمَّل من عنوانها هي ما يستهلك الوقت: سكربتاتها وصورها واستدعاءاتها لأطراف ثالثة. أما مصادر HTML ذات الموارد المضمنة أو القريبة فهي الأسرع.

الحصة الشهرية

تتضمن كل باقة عددًا من العمليات شهريًا؛ ويُعدّ ملف PDF واحد أو لقطة شاشة واحدة عملية واحدة، مهما كان حجمه أو عدد صفحاته. راجع الأسعار. لا تُرحَّل العمليات غير المستخدمة.