تمرير الملفات عبر عنوان URL
الشروط التي يجب أن يستوفيها رابط الملف، وأنواع المحتوى التي يقبلها كل إدخال.
لا توجد نقطة نهاية للرفع. يأخذ حقل الملف رابط HTTPS عام، الذي نجلبه ونتحقق منه وننسخه إلى مشروع Morphic الخاص بك قبل بدء التشغيل. يظل CDN الخاص بك هو المصدر الأصلي لمحتواك، وتستخدم الصور والفيديو والصوت والمستندات جميعًا عقدًا واحدًا.
يجب أن يستوفي كل رابط كل ما يلي
| المتطلب | التفاصيل |
|---|---|
| HTTPS | http العادي مرفوض |
| يقدّم الملف | يجب أن يكون جسم الاستجابة هو البايتات. تُرفض صفحة المعاينة أو المشاركة — عارض Drive، صفحة هبوط Dropbox، أو أي غلاف HTML — |
| اسم مضيف عام | أسماء مضيف فقط. عنوان IP، localhost أو اسم يُحلّ إلى عنوان خاص مرفوض |
| لا توجد بيانات اعتماد في عنوان URL | https://user:pass@… مرفوض. سلسلة استعلام موقعة مسبقًا مقبولة، ولا تُكتب أبدًا في سجلاتنا |
| نوع محتوى مدرج | يجب أن يكون Content-Type الخاص بالاستجابة أحد أنواع url_content_types الخاصة بذلك الإدخال |
| بايتات تطابق | تُفحص البايتات الأولى للملف مقابل النوع الذي قُدِّم به قبل الاحتفاظ به. تُرفض صورة PNG مُقدَّمة كملف PDF، أو صفحة HTML مُقدَّمة كـ JSON، أو أي ملف ZIP مُقدَّم كـ DOCX |
داخل max_bytes | يُتحقق من Content-Length أولًا، ثم يُفرض مرة أخرى أثناء تدفق البايتات |
| بحد أقصى 3 عمليات إعادة توجيه | يُرفض ما يزيد على ثلاث قفزات |
| صالح طوال عملية الجلب بالكامل | الرابط الذي تنتهي صلاحيته أثناء النقل يفشل التشغيل |
| غير فارغ | يُرفض الرابط الذي يقدّم صفر بايت |
| يُسلَّم بسرعة | يُرفض المضيف الذي لا يستطيع تسليم الملف بالكامل خلال نحو 40 ثانية، وتحصل روابط التشغيل مجتمعة على نحو 90 ثانية |
الرابط الموقّع ذو العمر القصير هو السبب المعتاد لملف جُلب جزئيًا. امنحه صلاحية تمتد لبضع دقائق على الأقل بعد لحظة بدء التشغيل.
أنواع المحتوى حسب نوع الإدخال
القائمة الدقيقة لكل إدخال موجودة في url_content_types. هذه هي الأنواع التي يمكن تهيئة كل نوع إدخال لقبولها.
| نوع الإدخال | أنواع المحتوى |
|---|---|
image | image/png, image/jpeg, image/webp, image/gif, image/tiff, image/avif, image/heic |
video | video/mp4, video/webm, video/quicktime, video/mpeg, video/x-matroska |
audio | audio/mpeg, audio/wav, audio/aac, audio/ogg, audio/mp4, audio/webm |
document | application/pdf, text/plain, text/markdown, text/csv, application/json، وDOCX |
يُرفض أي شيء غير موجود في قائمة الإدخال. لا يوجد نوع إدخال "أي ملف"، ولا يُوثق أبدًا بالامتداد — ما تكونه البايتات هو ما يعتد به.
الحدود القصوى لكل تشغيل
تُفرض حدود الروابط والبايتات لكل تشغيل عبر جميع مدخلات الملفات مجتمعة — انظر الأخطاء والحدود.