ForHosting KIT · أدوات المطورين

تحديد الفئة الجيلية حسب سنة الميلاد

أدخلوا سنة الميلاد لتحديد فئتها الجيلية الشائعة، بدءًا من الجيل الضائع وصولًا إلى جيل بيتا.

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

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

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

تعرّفوا إلى ما تعرضه نتيجة البحث

يستقبل بحث الفئة الجيلية سنة ميلاد واحدة ويقارنها بجدول ثابت من النطاقات الشاملة لطرفيها. تعرض الاستجابة الناجحة السنة المرسلة، واسم الفئة المعروف، وأول سنة وآخر سنة فيها. فعلى سبيل المثال، تُعاد السنة الواقعة بين 1981 و1996 ضمن جيل الألفية، بينما تُعاد السنة الواقعة بين 1997 و2012 ضمن الجيل Z. يتيح إدراج الحدود في كل استجابة فحص التصنيف بدل الاعتماد على تسمية ذات معيار خفي. يشمل البحث الجيل الضائع، والجيل الأعظم، والجيل الصامت، وجيل طفرة المواليد، والجيل X، وجيل الألفية، والجيل Z، وجيل ألفا، وجيل بيتا. تمثل هذه الأسماء اصطلاحات سكانية عامة وليست تشخيصًا شخصيًا. قد يعرّف المولودون قرب أحد الحدود أنفسهم باسم آخر، كما قد يعتمد الباحثون حدودًا مختلفة قليلًا. استخدموا النتيجة قاعدة تجميع متسقة للتحليل أو العرض أو التوجيه أو التعليم، ولا تستخدموها حكمًا على تفضيلات شخص أو سلوكه أو معتقداته أو هويته.

قدّموا سنة ميلاد صالحة

أرسلوا السنة عددًا صحيحًا في الحقل year. يستطيع الحل أيضًا توحيد نص مكتوب بصيغة عدد صحيح، لكن يُستحسن أن تستخدم برامج API عددًا صحيحًا في JSON لأنه أوضح تمثيل ويتوافق مع عقد الإدخال المعلن. تُرفض القيم العشرية والمنطقية والحقول الغائبة والكلمات الاعتباطية والأرقام غير الآمنة بدل تقريبها أو تخمينها. يمتد النطاق المدعوم من 1883 إلى 2039 شاملًا الطرفين، لأن لكل سنة فيه قيدًا صريحًا في جدول الفئات الثابت. تؤدي السنة السابقة لـ1883 أو اللاحقة لـ2039 إلى خطأ إدخال غير صالح. يمنع هذا القيد الأداة من اختراع تسميات تاريخية أو مستقبلية لا يدعمها اصطلاح معتمد. تنتمي سنوات الحدود إلى النطاقات المعروضة بدقة: سنة 1964 من طفرة المواليد، ويبدأ الجيل X في 1965، وتظل 1980 ضمن الجيل X، ويبدأ نطاق جيل الألفية في 1981. تجعل هذه المقارنة الشاملة عمليات التكامل قابلة للتوقع، وتوفر لجداول البيانات والنماذج والمعالجة الدفعية قاعدة بسيطة يمكن تكرارها عند مراجعة النتائج.

استخدموا التسميات بمسؤولية واتساق

تكون التسميات الجيلية أنفع بوصفها فئات وصفية عامة. يمكن أن تساعد في تلخيص توزيع جمهور، أو إضافة حقل مقروء إلى بيانات بحث مصدّرة، أو إعداد درس في التاريخ السكاني، أو تطبيق اصطلاح مشترك بين خدمات كانت تستخدم جداول متعارضة. احفظوا سنتي البداية والنهاية المعادتين مع التسمية عندما تكون قابلية التدقيق مهمة؛ فهذا يحفظ التعريف الدقيق المستخدم حتى إن فضّل منشور آخر حدودًا مختلفة. لا تستخدموا النتيجة بديلًا عن المعلومات المباشرة المتعلقة بشخص. لا تحدد مجموعات سنة الميلاد بموثوقية المهارة التقنية أو عادات الإنفاق أو الصحة أو السياسة أو الثقافة أو تفضيلات التواصل، وينبغي ألا توجه قرارات عالية الأثر بشأن الأهلية أو المعاملة. لا تنفذ الخوارزمية سوى التحقق والمقارنات الثابتة؛ فهي لا تصل إلى شبكة، ولا تستعلم عن الوقت الحالي، ولا تستخدم نموذجًا، ولا تستنتج شيئًا من اسم أو موقع. لذلك لا تتغير النتائج بين الطلبات. عبر API، تبلغ كلفة كل طلب $0.002. وهذا يجعل نقطة النهاية ملائمة للأتمتة القابلة للتكرار عندما تكون الأخطاء الصريحة والتصنيفات المستقرة أهم من التأويل التخَميني.

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

وحّدوا سجلات التحليلات

أضيفوا تسمية جيلية متسقة وحدودها إلى السجلات التي تتضمن أصلًا سنة ميلاد جُمعت بإذن مناسب.

أنشئوا خطوطًا زمنية تعليمية

حوّلوا سنوات الميلاد النموذجية إلى فترات سكانية معروفة للدروس أو الاختبارات أو العروض التاريخية.

دقّقوا تصنيفًا قائمًا

قارنوا تسمية جيلية محفوظة بنطاق ثابت وواضح، ثم ضعوا علامة على الاختلافات لمراجعتها.

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

ما نطاقات السنوات التي يستخدمها البحث؟

يستخدم نطاقات ثابتة شاملة من الجيل الضائع (1883–1900) إلى جيل بيتا (2025–2039)، مع الحدود الشائعة للفئات الواقعة بينهما.

ماذا يحدث عند إدخال سنة غير مدعومة؟

تعيد السنوات السابقة لـ1883 أو اللاحقة لـ2039 خطأ إدخال غير صالح بدل اختراع فئة جيلية.

هل حدود الأجيال متفق عليها عالميًا؟

لا. قد تختلف المصادر في سنوات الحدود. تستخدم هذه الأداة جدولًا ثابتًا وشائعًا لكي تظل النتائج المؤتمتة متسقة.

هل يمكن إرسال سنة عشرية؟

لا. يجب أن تكون سنة الميلاد عددًا صحيحًا آمنًا؛ وتُرفض القيم العشرية بدل تقريبها.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API مقدار $0.002. الحساب حتمي ولا يستدعي أي خدمة خارجية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/misc2/generation-cohort-lookup

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

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

curl -X POST https://api.kit.forhosting.com/misc2/generation-cohort-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990}'

const res = await fetch("https://api.kit.forhosting.com/misc2/generation-cohort-lookup", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 1990
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/misc2/generation-cohort-lookup",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1990
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/generation-cohort-lookup", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":1990}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":1990}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/generation-cohort-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "year": 1990
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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