agentHub
API

API-viite

Taydellinat REST API -dokumentaatio AILoft-integraatioon.

Perus-URL
Todennus
JSON-vastaukset

Todennus

Kaikki pyynnoet vaativat API-avaimen Authorization-otsakkeessa Bearer-tokenina.

// Header
Authorization: Bearer your-api-token

Pida API-avaimesi salassa. Ala koskaan paljasta sita asiakaskoodissa.

Paatepisteet

GET/api/agentsListaa kaikki saatavilla olevat agentit metatiedoilla, arvioinneilla ja hinnoilla.

Parametrit

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)
Vastaus: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugYksityiskohtaiset tiedot tietysta agentista.

Parametrit

slugstringUnique agent slug (URL param)
Vastaus: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsSivutetut arvostelut agentille.

Parametrit

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

Parametrit

slugstringAgent slug (URL param)
Vastaus: { agents: Agent[] }
POST/api/agents/:slug/installAsenna maksullinen agentti. Veloitetaan lompakosta.

Parametrit

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Vastaus: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeAsenna ilmainen agentti. Todennus vaaditaan.

Parametrit

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Vastaus: { ok: boolean }
POST/api/agents/:slug/reviews🔒Laeheta arvostelu asennetulle agentille.

Parametrit

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Vastaus: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Hae lompakkon saldo ja tapahtumahistoria.
Vastaus: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Tietotyypit

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)
Takaisin dokumentaatioonAloita kehittaeminen →