agentHub
API

API-reference

Komplet REST API-dokumentation til AILoft-integration.

Basis-URL
Autentificering
JSON-svar

Autentificering

Alle anmodninger kraever en API-nogle i Authorization-headeren som Bearer token.

// Header
Authorization: Bearer your-api-token

Hold din API-nogle hemmelig. Eksponér den aldrig i klient-kode.

Endpoints

GET/api/agentsListe over alle tilgaengelige agenter med metadata, vurderinger og priser.

Parametre

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)
Svar: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugDetaljeret information om en specifik agent.

Parametre

slugstringUnique agent slug (URL param)
Svar: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsPaginerede anmeldelser for en agent.

Parametre

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

Parametre

slugstringAgent slug (URL param)
Svar: { agents: Agent[] }
POST/api/agents/:slug/installInstallér betalt agent. Traekkes fra pungen.

Parametre

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Svar: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeInstallér gratis agent. Autentificering paakraevet.

Parametre

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Svar: { ok: boolean }
POST/api/agents/:slug/reviews🔒Indsend anmeldelse for en installeret agent.

Parametre

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Svar: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Hent pungsaldo og transaktionshistorik.
Svar: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Datatyper

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)
Tilbage til dokumentationBegynd at udvikle →