Skip to main content

​
Marketplace

The Profy marketplace is a consumer-facing storefront where users discover applications, browse skill catalogs, and manage their favorites. All marketplace data is publicly accessible — no authentication required for browsing.

​
Overview

​
Applications

Applications are the primary marketplace entity. Users can browse by category, search by keyword, view details, and mark favorites.

​
Application Lifecycle

FeatureDescription
CategoriesHierarchical classification with i18n support (locale parameter)
ListingPaginated browsing with category and keyword filters
Hot AppsCurated or algorithmically ranked popular applications
Detail ViewFull application metadata including description, pricing, and screenshots
FavoritesAuthenticated users can favorite/unfavorite apps (idempotent)

​
Application API Endpoints

MethodEndpointAuthDescription
GET/api/market/category/listNoList all categories (supports ?locale=)
POST/api/market/application/listNoSearch apps with filters and pagination
GET/api/market/application/detail/:appUuidNoGet full application details
GET/api/market/application/hotNoRetrieve trending / hot applications
POST/api/market/application/favoriteYesAdd app to favorites
POST/api/market/application/unfavoriteYesRemove app from favorites
POST/api/market/application/favorite/listYesList user’s favorite apps

​
Listing Request

interface ApplicationListRequest {
  categoryUuid?: string;
  keyword?: string;
  page: number;
  pageSize: number;
}
The response includes an isFavorited flag per application when the request includes a valid auth token.

​
Skills

Skills represent reusable capabilities that can be attached to agent instances. The skill marketplace supports tag-based filtering and source type classification.

​
Skill API Endpoints

MethodEndpointAuthDescription
POST/api/market/skill/listNoList skills with category, keyword, and tag filters
POST/api/market/skill/detailNoGet full skill details by skillUuid

​
Skill Filters

FilterTypeDescription
categoryUuidstringFilter by skill category
keywordstringFull-text keyword search
tagsstring[]Filter by one or more tags
sourceTypestringFilter by skill source type

​
Categories

Categories provide a hierarchical taxonomy for organizing both applications and skills. They support internationalization through the locale query parameter.

​
Favorites System

The favorites system lets authenticated users bookmark applications for quick access. Operations are idempotent — favoriting an already-favorited app or unfavoriting a non-favorited app both succeed silently.

​
Frontend Integration

The Portal marketplace is built with Next.js and uses next-intl for internationalization. Key pages include:
PageDescription
/marketplaceMain listing with category sidebar and search
/marketplace/[appUuid]Application detail page
/marketplace/skillsSkill catalog browser
/favoritesUser’s favorited applications

Authentication

Auth required for favorites and personalized features

Agent Platform

Skills integrate with Expert agent instances