agentHub
API

Tham chiếu API

Tài liệu REST API đầy đủ để tích hợp AILoft.

URL gốc
Xác thực
Phản hồi JSON

Xác thực

Tất cả yêu cầu cần khóa API trong header Authorization dạng token Bearer.

// Header
Authorization: Bearer your-api-token

Giữ bí mật khóa API. Không bao giờ để lộ trong mã phía client.

Endpoint

GET/api/agentsLiệt kê tất cả tác nhân có sẵn với metadata, đánh giá và giá.

Tham số

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)
Phản hồi: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugLấy thông tin chi tiết về tác nhân cụ thể.

Tham số

slugstringUnique agent slug (URL param)
Phản hồi: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsLấy đánh giá phân trang cho tác nhân.

Tham số

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

Tham số

slugstringAgent slug (URL param)
Phản hồi: { agents: Agent[] }
POST/api/agents/:slug/installCài đặt tác nhân trả phí. Trừ từ ví.

Tham số

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Phản hồi: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeCài đặt tác nhân miễn phí. Cần xác thực.

Tham số

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Phản hồi: { ok: boolean }
POST/api/agents/:slug/reviews🔒Gửi đánh giá cho tác nhân đã cài đặt.

Tham số

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Phản hồi: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Lấy số dư ví và lịch sử giao dịch.
Phản hồi: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Kiểu dữ liệu

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)
Quay lại Tài liệuBắt đầu phát triển →