agentHub
API

Referensi API

Dokumentasi REST API lengkap untuk mengintegrasikan AILoft.

URL Dasar
Autentikasi
Respons JSON

Autentikasi

Semua permintaan memerlukan kunci API di header Authorization sebagai token Bearer.

// Header
Authorization: Bearer your-api-token

Jaga kerahasiaan kunci API Anda. Jangan pernah mengeksposnya di kode sisi klien.

Endpoint

GET/api/agentsDaftar semua agen yang tersedia dengan metadata, rating, dan harga.

Parameter

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)
Respons: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugDapatkan info detail tentang agen tertentu.

Parameter

slugstringUnique agent slug (URL param)
Respons: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsDapatkan ulasan berpaginasi untuk sebuah agen.

Parameter

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

Parameter

slugstringAgent slug (URL param)
Respons: { agents: Agent[] }
POST/api/agents/:slug/installInstal agen berbayar. Memotong dari saldo dompet.

Parameter

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Respons: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeInstal agen gratis. Autentikasi diperlukan.

Parameter

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Respons: { ok: boolean }
POST/api/agents/:slug/reviews🔒Kirimkan ulasan untuk agen yang telah diinstal.

Parameter

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Respons: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Dapatkan saldo dompet dan riwayat transaksi.
Respons: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Tipe Data

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)
Kembali ke DokumentasiMulai Mengembangkan →