agentHub
API

مرجع API

توثيق REST API كامل لدمج AILoft.

عنوان URL الأساسي
المصادقة
استجابات JSON

المصادقة

جميع الطلبات تتطلب مفتاح API في رأس التفويض كرمز Bearer.

// Header
Authorization: Bearer your-api-token

حافظ على سرية مفتاح API. لا تكشفه أبدًا في كود جانب العميل.

نقاط النهاية

GET/api/agentsقائمة بجميع الوكلاء المتاحين مع البيانات الوصفية والتقييمات والأسعار.

المعاملات

categorystringFilter by category (Development, Analytics, Legal, ...)
searchstringSearch in name, description and tags
backendstringFilter by compatible backend (e.g. openai, claude, ollama)
pricingstringFilter: "free" or "paid"
sortstringSort: popular, newest, rating (default: newest)
pagenumberPage number (default: 1)
limitnumberResults per page (1–50, default: 12)
الاستجابة: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugالحصول على معلومات تفصيلية عن وكيل محدد.

المعاملات

slugstringUnique agent slug (URL param)
الاستجابة: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsالحصول على تقييمات مرقّمة الصفحات لوكيل.

المعاملات

slugstringAgent slug (URL param)
pagenumberPage number (default: 1)
limitnumberResults per page (1–50, default: 10)
الاستجابة: { reviews: Review[], total: number, page: number }
GET/api/agents/:slug/similarGet similar agents from the same category.

المعاملات

slugstringAgent slug (URL param)
الاستجابة: { agents: Agent[] }
POST/api/agents/:slug/installتثبيت وكيل مدفوع. يُخصم من المحفظة.

المعاملات

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
الاستجابة: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeتثبيت وكيل مجاني. تتطلب المصادقة.

المعاملات

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
الاستجابة: { ok: boolean }
POST/api/agents/:slug/reviews🔒إرسال تقييم لوكيل مثبّت.

المعاملات

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
الاستجابة: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒الحصول على رصيد المحفظة وسجل المعاملات.
الاستجابة: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

أنواع البيانات

Agent

  id: string
  slug: string
  name: string
  description: string
  icon: string | null
  category: string
  agentType: "prompt_based" | "app_ui"
  compatible: string[]
  tags: string[]
  pricing: { type: "one_time", amount?: number }
  rating: number
  installs: number
  isFeatured: boolean
  createdAt: string (ISO 8601)
  author: { id: string, name: string }

Review

  id: string
  rating: number (1–5)
  comment: string | null
  agentId: string
  userId: string
  user: { name, username, avatarUrl }
  createdAt: string (ISO 8601)
العودة إلى التوثيقابدأ التطوير →