agentHub
API

API-referentie

Volledige REST API-documentatie voor AILoft-integratie.

Basis-URL
Authenticatie
JSON-antwoorden

Authenticatie

Alle verzoeken vereisen een API-sleutel in de Authorization-header als Bearer token.

// Header
Authorization: Bearer your-api-token

Houd uw API-sleutel geheim. Nooit blootstellen in client-side code.

Endpoints

GET/api/agentsLijst van alle beschikbare agenten met metadata, beoordelingen en prijzen.

Parameters

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)
Antwoord: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugGedetailleerde informatie over een specifieke agent.

Parameters

slugstringUnique agent slug (URL param)
Antwoord: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsGepagineerde beoordelingen van een agent.

Parameters

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

Parameters

slugstringAgent slug (URL param)
Antwoord: { agents: Agent[] }
POST/api/agents/:slug/installBetaalde agent installeren. Wordt van het saldo afgetrokken.

Parameters

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Antwoord: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeGratis agent installeren. Authenticatie vereist.

Parameters

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Antwoord: { ok: boolean }
POST/api/agents/:slug/reviews🔒Beoordeling indienen voor een geinstalleerde agent.

Parameters

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Antwoord: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Saldo en transactiegeschiedenis ophalen.
Antwoord: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Gegevenstypen

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)
Terug naar documentatieBegin met ontwikkelen →