agentHub
API

API referencia

Teljes REST API dokumentáció az AILoft integrálásához.

Alap URL
Hitelesítés
JSON válaszok

Hitelesítés

Minden kérés API kulcsot igényel az Authorization fejlécben Bearer tokenként.

// Header
Authorization: Bearer your-api-token

Tartsa titokban API kulcsát. Soha ne tegye közzé kliensoldali kódban.

Végpontok

GET/api/agentsAz összes elérhető ügynök listája metaadatokkal, értékelésekkel és árakkal.

Paraméterek

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)
Válasz: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugRészletes információ egy adott ügynökről.

Paraméterek

slugstringUnique agent slug (URL param)
Válasz: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsLapozott értékelések egy ügynökről.

Paraméterek

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

Paraméterek

slugstringAgent slug (URL param)
Válasz: { agents: Agent[] }
POST/api/agents/:slug/installFizetős ügynök telepítése. Levonás a pénztárcából.

Paraméterek

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Válasz: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeIngyenes ügynök telepítése. Hitelesítés szükséges.

Paraméterek

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Válasz: { ok: boolean }
POST/api/agents/:slug/reviews🔒Értékelés beküldése telepített ügynökről.

Paraméterek

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Válasz: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Pénztárca egyenleg és tranzakciótörténet megtekintése.
Válasz: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Adattípusok

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)