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

إنشاء علامات hreflang للصفحات متعددة اللغات

يحوّل منشئ علامات hreflang قائمة منظّمة من نسخ الصفحات اللغوية أو الإقليمية إلى عناصر link بصيغة HTML جاهزة للإدراج.

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

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

تُدخل رمز كل لغة أو منطقة وعنوان URL المطلق الخاص بها، ويمكنك إضافة وجهة عامة من نوع x-default، ثم تحصل على سجلات منفصلة وكتلة HTML كاملة. تتحقق الأداة من البنية، وتوحّد حالة الأحرف المتعارف عليها، وترفض التكرار، وتحمي قيم السمات عند إدراجها في HTML. وهي مناسبة للمواقع متعددة اللغات والكتالوجات الدولية وبوابات الوثائق ومسارات النشر التي تحتاج إلى تعريف الصفحات البديلة بصورة متسقة.

أنشئ خريطة مكتملة للغات والمناطق

أضف صفاً لكل صفحة مكافئة ضمن المجموعة نفسها متعددة اللغات أو المناطق. يحتاج كل صف إلى رمز لغة أو منطقة وإلى عنوان URL مطلق يستخدم HTTP أو HTTPS. يكفي رمز أساسي مثل ar أو fr عندما تخدم صفحة واحدة جميع الناطقين باللغة ذاتها. أضف منطقة مثل ar-EG أو fr-CA عندما تختلف الأسعار أو التوافر أو الصياغة أو الأحكام القانونية بين الأسواق. ويمكن لتعيين كتابة من أربعة أحرف أن يميز أنظمة الكتابة، كما في zh-Hans أو sr-Latn. تقبل الأداة لغة من حرفين أو ثلاثة، ثم كتابة اختيارية، ثم منطقة اختيارية من حرفين أو ثلاثة أرقام. كما توحّد حالة الأحرف المعتادة حتى لا ينتج ترميز غير متسق عن اختلاف الإدخال. أدرج الصفحة الحالية مع جميع بدائلها، لأن مجموعة hreflang تصف المجموعة كاملة ولا تقتصر على الروابط الخارجة. استخدم عناوين قانونية قابلة للفهرسة ومطابقة للغة أو السوق المذكور. تحتفظ النتيجة بترتيب الصفوف، مما يجعل الكتلة ثابتة ويسهّل مراجعتها في نظام إدارة الإصدارات.

اختر x-default بصورة مقصودة

استخدم الحقل الاختياري x-default للصفحة التي ينبغي عرضها عندما لا تناسب الزائر أي نسخة لغوية أو إقليمية معلنة. قد تكون هذه الصفحة محدد لغة، أو بوابة دولية، أو نسخة محايدة تتيح اختيار السوق. لا تُدخل x-default كسطر لغة عادي؛ فالحقل المخصص يمنع تعريفات الرجوع المكررة أو الملتبسة ويضع الرابط دائماً بعد الروابط المحلية. ويمكن تركه فارغاً إذا لم توجد وجهة عامة مفيدة. يحتوي HTML الناتج على عنصر link لكل تعيين، ويضيف عند الطلب عنصراً آخر لـx-default. ضع الكتلة كاملة داخل head في كل صفحة من صفحات المجموعة، أو أرسل ترويسات Link مكافئة إذا كان تطبيقك يدير البدائل على مستوى HTTP. حافظ على التبادلية، بحيث تشير كل صفحة إلى نفسها وإلى مجموعة البدائل ذاتها. تنشئ هذه الأداة التعريف بدقة، لكنها لا تتحقق من نشر الصفحات البعيدة للروابط المقابلة، ولا من قابليتها للفهرسة، ولا من عمليات إعادة التوجيه. استخدم تدقيقاً أو زحفاً مستقلاً لهذه الفحوص.

تحقق من الناتج وانشره وحافظ عليه

ترفض الأداة الرموز غير الصحيحة بدلاً من إخراجها بصمت. وبذلك تكشف الشرطات السفلية والمسافات المحيطة وغياب جزء اللغة والتعيينات الإضافية غير المدعومة ووضع x-default داخل القائمة العادية. كما ترفض التكرار بعد التوحيد، فلا يمكن أن ينشئ en-us وen-US وجهتين متنافستين. يجب أن تكون عناوين URL مطلقة وأن تستخدم HTTP أو HTTPS؛ فالمسارات النسبية والمخططات الأخرى لا تعرّف صفحات قابلة للزحف. بعد نجاح التحقق، انسخ الحقل html إلى القالب، أو استخدم مصفوفة links إذا كان إطار العمل يرسم بيانات head بنفسه. يعرض كل سجل قيمة hreflang الموحّدة وعنوان URL الأصلي والعلامة المكتملة، مما يناسب تكاملات CMS ومسارات البناء. أعد إنشاء الكتلة عند تغيير المسارات أو إطلاق سوق جديد أو نقل الوجهة العامة. تعامل مع الخريطة بوصفها إعداداً دائماً للموقع، لا مقتطفاً لمرة واحدة. في العمليات الآلية، احفظ الإدخال بجانب تعريفات المسارات وقارن الناتج أثناء النشر. تبلغ تكلفة كل طلب API مقدار $0.002؛ يناسب المتصفح المهام الفردية، بينما تناسب API الحتمية عمليات النشر المتكررة.

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

إطلاق متجر إقليمي

أنشئ بدائل متسقة لصفحات المنتجات الخاصة بكل بلد، مع محدد دولي بوصفه x-default.

نشر وثائق مترجمة

حوّل مسارات الوثائق المترجمة إلى كتلة HTML ثابتة يمكن تضمينها في كل عملية بناء للموقع.

أتمتة بيانات CMS الوصفية

استخدم الروابط المنظّمة لملء بيانات head عندما يضيف المحررون صفحة مترجمة أو ينقلونها.

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

ما صيغ رموز اللغات والمناطق المقبولة؟

استخدم لغة من حرفين أو ثلاثة، ويمكن أن تتبعها كتابة من أربعة أحرف ومنطقة من حرفين أو ثلاثة أرقام، مثل ar أو zh-Hans أو es-419.

هل يضيف المنشئ x-default؟

نعم. أدخل عنوان x_default الاختياري، وستُضاف علامته بعد العلامات الخاصة باللغات.

لماذا تُرفض رموز اللغات المكررة؟

ينبغي أن يكون لكل قيمة hreflang وجهة واحدة داخل المجموعة. تُقارن الرموز بعد توحيد حالة الأحرف.

هل تتحقق الأداة من الروابط المتبادلة في الصفحات؟

لا. تنشئ الترميز دون اتصال بالشبكة. استخدم مدقق hreflang أو عملية زحف لتدقيق الموقع المنشور.

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

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن تشغيل عملية الإنشاء الحتمية نفسها في المتصفح أيضاً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/hreflang-tags-generate

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

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

curl -X POST https://api.kit.forhosting.com/web/hreflang-tags-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"locales":[{"locale":"en","url":"https://example.com/en/product"},{"locale":"fr-FR","url":"https://example.com/fr/produit"}]}'

const res = await fetch("https://api.kit.forhosting.com/web/hreflang-tags-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "locales": [
      {
        "locale": "en",
        "url": "https://example.com/en/product"
      },
      {
        "locale": "fr-FR",
        "url": "https://example.com/fr/produit"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/hreflang-tags-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "locales": [
        {
            "locale": "en",
            "url": "https://example.com/en/product"
        },
        {
            "locale": "fr-FR",
            "url": "https://example.com/fr/produit"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/hreflang-tags-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"locales":[{"locale":"en","url":"https://example.com/en/product"},{"locale":"fr-FR","url":"https://example.com/fr/produit"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"locales":[{"locale":"en","url":"https://example.com/en/product"},{"locale":"fr-FR","url":"https://example.com/fr/produit"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/hreflang-tags-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "locales": [
    {
      "locale": "en",
      "url": "https://example.com/en/product"
    },
    {
      "locale": "fr-FR",
      "url": "https://example.com/fr/produit"
    }
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.hreflang_tags_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 الكامل ←