نظرة شاملة على البيانات
ملخص الحالة والتوقعات والإشارات والسجل وبيانات المصادر الوصفية. مناسب ليكون أول طلب للتطبيق.
01 / نقاط النهاية
JSONقائمة الواجهات
اختر البيانات بحسب الغرض، لتجنب جلب الإعلان نفسه من المصدر الخارجي أكثر من مرة.
إشارات متعلقة بإعادة الضبط
تصفية أخبار إعادة الضبط والخطط والتلميحات والحصص من المنشورات العامة، مع الاحتفاظ بالتصنيف وحالة التحقق.
سجل إعلانات إعادة الضبط
إعلانات إعادة الضبط التي جُمعت. إعلان الاكتمال لا يعني التحقق من حصة حسابك الشخصي.
GET
/api/v1/tibo منشورات Tibo العامة
جميع المنشورات الصالحة التي جُمعت، وتشمل النص الأصلي ووقت النشر والرابط وطريقة الجمع.
GET
/api/health حالة الخدمة
التحقق من توفر الخدمة ومصادر البيانات، لاستخدامه في فحوص النشر والمهام المجدولة.
سجل المنشورات الدائم
منشورات أصلية ومصادر جمع محفوظة دائمًا مع تقسيم الصفحات. لا نضمن اكتمال السجل السابق لأول عملية جمع.
نموذج احتمالية تجريبي
يعيد خط الأساس التاريخي والتعديلات التجريبية وتأثير كل منشور. القواعد غير معايرة، وتحافظ واجهة التوقع الأصلية على خط أساس المصدر.
الحقل:
/api/v1/overviewprobability_model → baseline / adjusted / factors / model_version / evaluated_attibo_history → total / persistent / complete_historyمعلمات الاستعلام
التصفية وتقسيم النتائج إلى صفحات
ينطبق على واجهات قوائم signals وresets وtibo.
| المعلمة | الوصف |
|---|---|
limit / offset | تتراوح limit بين 1–100، وقيمتها الافتراضية 50؛ تبدأ offset من 0. تُعاد next_offset لاستخدامها في الصفحة التالية. |
kind | يمكن أن تكون kind إحدى القيم reported_completed أو planned أو hint أو limits أو banked أو unclear أو needs_context أو other؛ أما type فهو اسم بديل للتوافق. |
q | البحث بكلمة مفتاحية، بحد أقصى 200 حرف. |
from / to | نطاق تواريخ بتوقيت UTC، بالصيغة YYYY-MM-DD. |
تتضمن استجابة القائمة items وcount وtotal وlimit وoffset وnext_offset.عرض مثال على التصفية ↗
02 / فهم الاستجابة
تحقق من الحالة أولًا، ثم استخدم البيانات.
| الحقل | كيفية فهمه |
|---|---|
available | ما إذا كانت هناك لقطة بيانات متاحة حاليًا. عند عدم توفرها، اعرض حالة واضحة لغياب البيانات. |
stale | ما إذا كانت البيانات من نسخة مخزنة مؤقتًا انتهت صلاحيتها. حتى عند الاحتفاظ بالبيانات، ينبغي توضيح مدى حداثتها للمستخدم. |
generated_at | وقت إنشاء استجابة API الحالية، ولا يحل محل وقت نشر المنشور أو وقت جمعه. |
channels | تُسجل fetched_at وchecked_at وحالة التوفر والأخطاء لكل مصدر. |
posts | النص الأصلي وعنوان URL الأصلي ووقت النشر والتصنيف وحالة التحقق من المنشور. |
quota_verified | ما إذا جرى التحقق من حصة الحساب الفعلية. عندما تكون القيمة false، لا يجوز عرضها على أنها «تمت استعادة الحصة». |
tibo.mode | تُستخدم x_api أو third_party_copy أو unavailable للتمييز بين الجمع المباشر والنسخة من جهة خارجية وعدم توفر المصدر. |
حقلا التوقعات probability_24h / probability_48h هما نسبتان مئويتان بين 0 و100. عند عدم توفر توقعات، اعرض قيمة مجهولة ولا تستبدلها بـ 0%.
03 / التكامل
مثال بسيط للاتصال.
لا تتطلب واجهات القراءة GET مصادقة، وتسمح بالطلبات من نطاقات أخرى.
const response = await fetch(
'https://codexreset-news.com/api/v1/overview',
{ headers: { Accept: 'application/json' } }
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
if (!data.available) {
// اعرض «البيانات غير متاحة حاليًا»، ولا تستنتج أن إعادة الضبط لم تحدث.
} else {
const posts = data.tibo?.items ?? data.posts ?? [];
const cached = data.stale === true;
// اعرض الرابط الأصلي واحتفظ بالإشارة إلى مصدر بيانات الجهة الخارجية.
}تتطلب واجهة تحديث البيانات المجمعة مصادقة منفصلة؛ لا تحتاج الواجهة الأمامية إلى الاحتفاظ بمفتاح الجمع.عرض حالة الخدمة الحالية ↗
04 / التوافق
متوافق مع الطلبات الحالية.
تستمر الواجهات القديمة في توفير البيانات. يُنصح باستخدام واجهات v1 ذات الإصدار المحدد للتكاملات الجديدة.