// api

مرجع API

وثائق REST API للمطورين

AI Score هو مؤشر الجودة الأساسي

AI Score (٠-١٠٠) هو مؤشر الجودة الأساسي، وينتج عن مراجعة آلية لمحتوى SKILL.md لكل مهارة. أزيل نظام تقييم المستخدمين من الواجهة؛ وتُحفظ اندبوينتات /api/ratings للتوافق السابق وهي الآن منسوخة. غالبًا تكون حقول rating/ratingCount في ردود /api/skills بقيمة null. اعتمد على aiScore.

عنوان الأساس

https://skills.palebluedot.live

المصادقة

معظم نقاط النهاية عامة ولا تتطلب مصادقة. نقاط النهاية التي تعدّل بيانات المستخدم تتطلب مصادقة GitHub OAuth عبر ملفات تعريف ارتباط الجلسة.

سجّل الدخول في skills.palebluedot.live لإنشاء جلسة. تعيد نقاط النهاية الموثقة 401 عند عدم وجود جلسة صالحة.

تحديد المعدّل

كل نقاط النهاية محددة المعدّل باستخدام خوارزمية نافذة منزلقة. تُضمّن ترويسات تحديد المعدّل في الاستجابات.

المستوى	الحد	الاستخدام
مجهول	120 req/min	نقاط قراءة عامة
بحث	60 req/min	البحث وجلب الملفات
موثّق	600 req/min	إجراءات المستخدم عند تسجيل الدخول

ترويسات الاستجابة

X-RateLimit-Limit — الحد الأقصى للطلبات في النافذة

X-RateLimit-Remaining — الطلبات المتبقية في النافذة الحالية

X-RateLimit-Reset — طابع Unix الزمني عند إعادة ضبط النافذة

استجابات الخطأ

تتبع كل الأخطاء صيغة JSON متسقة.

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded",
  "retryAfter": 45,
  "limit": 60
}

رموز الحالة الشائعة

400 — طلب غير صالح — معاملات مفقودة أو غير صالحة

401 — غير مصرح — المصادقة مطلوبة

404 — غير موجود — المورد غير موجود

429 — طلبات كثيرة جدًا — تم تجاوز حد المعدّل

500 — خطأ داخلي في الخادم

Quick Example

curl "https://skills.palebluedot.live/api/skills?q=code-review&limit=5"

المهارات

البحث والتصفح واسترجاع معلومات المهارات

البحث عن المهارات مع البحث النصي الكامل والمرشحات والترقيم

جلب معلومات تفصيلية عن مهارة محددة

جلب المهارات المميّزة والشائعة

جلب المهارات المضافة أو المحدّثة حديثًا

تسجيل تثبيت مهارة

طلب فهرسة مهارة جديدة

طلب إزالة مهارة تملكها

ملفات المهارة

جلب محتويات ملفات المهارة وتنزيلها كملف ZIP

جلب كل الملفات داخل مجلد المهارة مع المحتوى

تنزيل ملفات المهارة كأرشيف ZIP

إجراءات المستخدم

التقييمات والمفضلات وإدارة المهارات

جلب التقييمات والمراجعات لمهارة

إنشاء تقييمك لمهارة أو تحديثه

جلب تقييمك الخاص لمهارة محددة

جلب قائمة المهارات المفضلة لديك

إضافة مهارة إلى المفضلة

إزالة مهارة من المفضلة

التحقق من المهارات الموجودة في المفضلة

الاكتشاف والبيانات الوصفية

التصنيفات والإحصاءات وصحة المنصة

جلب كل تصنيفات المهارات مع الأعداد

جلب إحصاءات السوق العامة

فحص حالة API والخدمات

جلب إحصاءات الإسناد ومصادر البيانات

النشرة

الاشتراك وإلغاء الاشتراك من النشرة

اشتراك بريد إلكتروني في النشرة

إلغاء اشتراك بريد إلكتروني من النشرة