agentHub
API

API-referens

Komplett REST API-dokumentation for AILoft-integration.

Bas-URL
Autentisering
JSON-svar

Autentisering

Alla forfrAgningar kraver API-nyckel i Authorization-headern som Bearer token.

// Header
Authorization: Bearer your-api-token

HAll din API-nyckel hemlig. Exponera den aldrig i klientkod.

Endpoints

GET/api/agentsLista alla tillgangliga agenter med metadata, betyg och priser.

Parametrar

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/:slugDetaljerad information om en specifik agent.

Parametrar

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

Parametrar

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.

Parametrar

slugstringAgent slug (URL param)
Svar: { agents: Agent[] }
POST/api/agents/:slug/installInstallera betald agent. Dras frAn plAnboken.

Parametrar

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

Parametrar

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Svar: { ok: boolean }
POST/api/agents/:slug/reviews🔒Skicka recension for en installerad agent.

Parametrar

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Svar: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒HAmta plAnbokssaldo och 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)
Tillbaka till dokumentationBOrja utveckla →