agentHub
API

API Referansı

AILoft entegrasyonu için eksiksiz REST API dokümantasyonu.

Temel URL
Kimlik Doğrulama
JSON Yanıtları

Kimlik Doğrulama

Tüm istekler Authorization başlığında Bearer token olarak API anahtarı gerektirir.

// Header
Authorization: Bearer your-api-token

API anahtarınızı gizli tutun. İstemci tarafı kodda asla açığa çıkarmayın.

Uç Noktalar

GET/api/agentsTüm mevcut ajanları meta veri, değerlendirme ve fiyatlarıyla listeler.

Parametreler

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)
Yanıt: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugBelirli bir ajan hakkında detaylı bilgi alır.

Parametreler

slugstringUnique agent slug (URL param)
Yanıt: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsBir ajan için sayfalanmış değerlendirmeler alır.

Parametreler

slugstringAgent slug (URL param)
pagenumberPage number (default: 1)
limitnumberResults per page (1–50, default: 10)
Yanıt: { reviews: Review[], total: number, page: number }
GET/api/agents/:slug/similarGet similar agents from the same category.

Parametreler

slugstringAgent slug (URL param)
Yanıt: { agents: Agent[] }
POST/api/agents/:slug/installÜcretli bir ajanı kurar. Cüzdandan düşer.

Parametreler

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Yanıt: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeÜcretsiz bir ajanı kurar. Kimlik doğrulama gerektirir.

Parametreler

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Yanıt: { ok: boolean }
POST/api/agents/:slug/reviews🔒Kurulu bir ajan için değerlendirme gönderir.

Parametreler

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Yanıt: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Cüzdan bakiyesi ve işlem geçmişini gösterir.
Yanıt: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Veri Türleri

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)
Dokümantasyona DönGeliştirmeye Başlayın →