agentHub
API

API संदर्भ

AILoft इंटीग्रेट करने के लिए संपूर्ण REST API प्रलेखन।

बेस URL
प्रमाणीकरण
JSON प्रतिक्रियाएं

प्रमाणीकरण

सभी अनुरोधों के लिए Authorization हेडर में Bearer टोकन के रूप में API कुंजी आवश्यक है।

// Header
Authorization: Bearer your-api-token

अपनी API कुंजी गुप्त रखें। इसे कभी क्लाइंट-साइड कोड में उजागर न करें।

एंडपॉइंट

GET/api/agentsमेटाडेटा, रेटिंग और मूल्य के साथ सभी उपलब्ध एजेंटों की सूची।

पैरामीटर

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)
प्रतिक्रिया: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugकिसी विशिष्ट एजेंट के बारे में विस्तृत जानकारी प्राप्त करें।

पैरामीटर

slugstringUnique agent slug (URL param)
प्रतिक्रिया: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsएजेंट के लिए पृष्ठांकित समीक्षाएं प्राप्त करें।

पैरामीटर

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

पैरामीटर

slugstringAgent slug (URL param)
प्रतिक्रिया: { agents: Agent[] }
POST/api/agents/:slug/installसशुल्क एजेंट इंस्टॉल करें। वॉलेट से कटौती।

पैरामीटर

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
प्रतिक्रिया: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeमुफ्त एजेंट इंस्टॉल करें। प्रमाणीकरण आवश्यक।

पैरामीटर

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
प्रतिक्रिया: { ok: boolean }
POST/api/agents/:slug/reviews🔒इंस्टॉल किए गए एजेंट के लिए समीक्षा सबमिट करें।

पैरामीटर

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
प्रतिक्रिया: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒वॉलेट बैलेंस और लेनदेन इतिहास प्राप्त करें।
प्रतिक्रिया: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

डेटा प्रकार

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)