للمطورين والوكلاء

تتوفر جميع القوائم والمنشورات أيضًا بصيغتي Markdown وJSON، بالمحتوى نفسه الموجود في الصفحة. لا تحتاج إلى مفتاح أو تسجيل دخول. تُخزّن الاستجابات مؤقتًا لمدة دقيقة تقريبًا، لذا يُرجى إبقاء الطلبات الآلية بمعدل أقل من طلب واحد في الثانية.

Markdown

احذف الشرطة المائلة من نهاية عنوان الصفحة وأضف .md. يتضمن المنشور ملخصه ومصادره وسلسلة التعليقات كاملة.

/ar/index.md: الصفحة الرئيسية
/ar/{new|best|ask|show|jobs}.md: الأحدث، الأفضل، Ask XO، Show XO وJob XO
/ar/{id}.md: منشور واحد مع جميع تعليقاته
?p=2: الصفحة التالية

curl -s https://startupxo.com/ar/index.md

JSON API

تدعم الاستجابات CORS، وتصف مواصفات OpenAPI كل حقل. اضبط lang على ko أو en أو ja أو es أو ar للحصول على ترجمات تمت مراجعتها.

/api/v1/{front|new|best|ask|show|jobs}.json?lang=ar&page=1: القوائم، 30 عنصرًا في الصفحة، حتى 20 صفحة
/api/v1/item.json?id={id}&lang=ar: منشور واحد مع تعليقات متداخلة
/api/v1/search.json?q={query}&lang=ar: البحث. يمكنك استخدامه مع kind وsort=points وdays=7 أو 30 أو 365.
/api/v1/user.json?handle={handle}: الملف الشخصي العام لشخص ومنشوراته
/openapi.json: مواصفات OpenAPI 3.1
/api/v1/: فهرس نقاط النهاية

curl -s "https://startupxo.com/api/v1/front.json?lang=ar" | jq '.items[] | {id, title, score, comments}'

فهم الحقول

score: عدد الأصوات. تبدأ منشورات الأشخاص بصوت واحد، والمنشورات المجمعة بصفر.
origin: تشير community إلى منشور كتبه شخص، وتشير curated إلى منشور جُمع ولُخص تلقائيًا.
summary: من سطرين إلى خمسة أسطر من الحقائق التي جرى التحقق منها بالرجوع إلى المصدر.
editorial: التعليقات التي تكون فيها قيمة editorial هي true صادرة عن حساب التحرير. يوضح سطر O الحالات التي تستحق التجربة، وسطر X ما ينبغي التحقق منه أولًا.

الخلاصات

/ar/rss.xml: الصفحة الرئيسية، الأحدث، Ask XO، Show XO، Job XO، الأفضل والتعليقات
/ar/rss.xml?user={handle}: منشورات شخص واحد
/llms.txt: ملاحظات لوكلاء الذكاء الاصطناعي