ForHosting KIT · قراءة المواقع ومراقبتها

إنشاء وسم preload للخطوط وCSS والبرامج النصية والصور

أنشئ رابط تحميل مسبق جاهزًا للصق من دون حفظ العلاقة بين الملف ووجهته في HTML وسلوك العبور بين الأصول. أدخل عنوان URL مطلقًا أو نسبيًا وحدد المورد بوصفه خطًا أو نمطًا أو برنامجًا نصيًا أو صورة. تستخدم النتيجة سمة as المناسبة، وتحمي العنوان داخل سمة HTML، وتضيف العبور المجهول للخطوط. أما النوع غير المدعوم فينتج خطأ إدخال واضحًا.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

اختر المورد الجدير بطلب مبكر

يمثل preload تلميحًا محددًا لتحسين الأداء، وليس أمرًا بجلب جميع الملفات مقدمًا. استخدمه لمورد ستحتاج إليه الصفحة قريبًا وقد يكتشفه المتصفح متأخرًا، مثل خط رئيسي مشار إليه في CSS، أو صورة بارزة، أو ورقة أنماط مهمة، أو برنامج نصي للعرض الأولي. أدخل عنوان URL الدقيق بما فيه المسار أو الاستعلام أو بصمة المحتوى. تقبل العناوين المطلقة والنسبية إلى البروتوكول أو الجذر أو المستند. يحافظ المولد على العنوان ويستبدل المحارف ذات الدلالة الخاصة داخل سمة HTML بأمان. اختر النوع وفق طريقة استهلاك المورد: font أو style أو script أو image. تكون النتيجة عنصر link كاملًا جاهزًا لرأس المستند.

افهم سمتي as وcrossorigin

تخبر سمة as المتصفح بوجهة الاستجابة المحملة مسبقًا، فتؤثر في الأولوية وسياسة الأمان وإمكان إعادة الاستخدام. يطابق كل نوع مقبول وجهته القياسية مباشرة. تحصل الخطوط على crossorigin="anonymous" لأن طلباتها تستخدم CORS، حتى في حالات شائعة يبدو فيها العنوان من الأصل نفسه. قد يؤدي حذفها إلى تنزيل الملف مرة ثانية. لا تضاف crossorigin تلقائيًا إلى الأنواع الأخرى لأن الوضع الصحيح يتوقف على الطلب اللاحق. كذلك لا يخمن المولد سمات type أو media أو imagesrcset أو integrity أو fetchpriority، إذ لا تكفي خانتا الإدخال لتعيينها بصورة موثوقة.

ضع الوسم بعناية وتحقق من إعادة الاستخدام

ضع الرابط المولد مبكرًا في رأس المستند، قبل CSS أو البرنامج النصي الذي كان سيكشف المورد عادةً. حافظ على تطابق href مع الطلب اللاحق؛ فقد يمنع اختلاف المضيف أو المسار أو الاستعلام أو إعادة التوجيه أو وضع CORS إعادة الاستخدام. افحص تحميلًا جديدًا في أدوات المتصفح. ينبغي طلب المورد مرة واحدة واستهلاكه بعد ذلك بقليل. تحقق من تحذيرات preload غير المستخدم، فهي غالبًا تشير إلى عنوان غير مطابق أو ملف غير ضروري في العرض الأولي. قد تتنافس كثرة التلميحات مع التنزيلات المهمة وتسيء إلى الأداء. تعامل مع كل وسم بوصفه فرضية قابلة للقياس، لا نصًا ثابتًا دائمًا.

حالات الاستخدام

تحميل خط الويب الرئيسي مسبقًا

أنشئ preload للخط مع وضع العبور المجهول اللازم لإعادة استخدامه في الطلب اللاحق.

منح الصورة البارزة أولوية

ولد preload لعنوان ثابت ومهم للجزء الظاهر أولًا من الصفحة.

إعداد HTML للنشر

أنشئ ترميزًا حتميًا لملفات CSS أو البرامج النصية ذات البصمة ضمن مسار الإصدار.

الأسئلة الشائعة

ما أنواع الموارد المدعومة؟

القيم المقبولة هي font وstyle وscript وimage، وتنتج أي قيمة أخرى خطأ إدخال.

لماذا تتضمن الخطوط crossorigin؟

تستخدم طلبات الخطوط CORS، وتتيح مطابقة الوضع إعادة استخدام preload بلا تنزيل جديد.

هل يمكن أن يكون عنوان URL نسبيًا؟

نعم. تقبل العناوين المطلقة والنسبية إلى البروتوكول أو الجذر أو المستند.

هل يتحقق المولد من وجود المورد؟

لا. لا يجري طلبًا شبكيًا؛ بل يتحقق من النص ويحميه ثم يولد ترميزًا حتميًا.

هل يضمن preload عرضًا أسرع؟

لا. فهو يغير الاكتشاف والأولوية؛ لذلك قس الصفحة لأن التحميل غير الضروري قد يضر بالأداء.

ما تكلفة طلب API؟

السعر الأساسي هو $0.002 لكل عنصر مولد. ويمكن للمتصفح تنفيذ المنطق الحتمي نفسه محليًا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/web/preload-link-generate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/web/preload-link-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"/assets/site.woff2","type":"font"}'

const res = await fetch("https://api.kit.forhosting.com/web/preload-link-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "/assets/site.woff2",
    "type": "font"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/preload-link-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "url": "/assets/site.woff2",
    "type": "font"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/preload-link-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"url":"/assets/site.woff2","type":"font"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"/assets/site.woff2","type":"font"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/preload-link-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "url": "/assets/site.woff2",
  "type": "font"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.preload_link_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←