agentHub
API

API-referanse

Komplett REST API-dokumentasjon for AILoft-integrasjon.

Basis-URL
Autentisering
JSON-svar

Autentisering

Alle foresporsler krever API-nokkel i Authorization-headeren som Bearer token.

// Header
Authorization: Bearer your-api-token

Hold API-nokkelen hemmelig. Aldri eksponér den i klientkode.

Endepunkter

GET/api/agentsList alle tilgjengelige 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/:slugDetaljert informasjon om en spesifikk agent.

Parametre

slugstringUnique agent slug (URL param)
Svar: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsPaginerte 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/installInstaller betalt agent. Trekkes fra lommeboken.

Parametre

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Svar: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeInstaller gratis agent. Autentisering pakreves.

Parametre

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

Parametre

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Svar: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Hent lommeboksaldo og transaksjonshistorikk.
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)
Tilbake til dokumentasjonBegynn a utvikle →