agentHub
API

Referință API

Documentație REST API completă pentru integrarea AILoft.

URL de bază
Autentificare
Răspunsuri JSON

Autentificare

Toate cererile necesită o cheie API în antetul Authorization ca token Bearer.

// Header
Authorization: Bearer your-api-token

Păstrați cheia API secretă. Nu o expuneți niciodată în codul client.

Endpoint-uri

GET/api/agentsLista tuturor agenților disponibili cu metadate, evaluări și prețuri.

Parametri

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)
Răspuns: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugInformații detaliate despre un agent specific.

Parametri

slugstringUnique agent slug (URL param)
Răspuns: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsRecenzii paginate pentru un agent.

Parametri

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

Parametri

slugstringAgent slug (URL param)
Răspuns: { agents: Agent[] }
POST/api/agents/:slug/installInstalarea unui agent plătit. Se deduce din portofel.

Parametri

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Răspuns: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeInstalarea unui agent gratuit. Necesită autentificare.

Parametri

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Răspuns: { ok: boolean }
POST/api/agents/:slug/reviews🔒Trimiteți o recenzie pentru un agent instalat.

Parametri

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Răspuns: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Vizualizați soldul portofelului și istoricul tranzacțiilor.
Răspuns: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Tipuri de date

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)
Înapoi la documentațieÎncepeți dezvoltarea →