API
Welcome to AppClust API
AppClust provides a powerful API for managing your applications, users, and analytics. This documentation will help you get started with our API endpoints.
Authentication
POST
/api/v1/user/login
Authenticate user and get session token.
Request
curl -X POST https://api.appclust.com/api/v1/user/login \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "your-password"
}'
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "your-password"
}'
POST
/api/v1/user/verifySession
Verify user session token.
Request
curl -X POST https://api.appclust.com/api/v1/user/verifySession \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
Domains
POST
/api/v1/domain/list
Get list of domains.
Request
curl -X POST https://api.appclust.com/api/v1/domain/list \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
Settings
POST
/api/v1/settings/all
Get all settings. Requires authentication.
Request
curl -X POST https://api.appclust.com/api/v1/settings/all \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token"
Dynamic Table Operations
POST
/api/v1/{tableClass}/list
Get list of items from a dynamic table. Requires authentication.
Request
curl -X POST https://api.appclust.com/api/v1/users/list \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"page": 1,
"per_page": 10,
"filters": {}
}'
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"page": 1,
"per_page": 10,
"filters": {}
}'
POST
/api/v1/{tableClass}/itemDetails
Get details of a specific item from a dynamic table. Requires authentication.
Request
curl -X POST https://api.appclust.com/api/v1/users/itemDetails \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"id": 123
}'
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"id": 123
}'
POST
/api/v1/{tableClass}/saveToDB
Save or update an item in a dynamic table. Requires authentication.
Request
curl -X POST https://api.appclust.com/api/v1/users/saveToDB \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"id": 123,
"name": "John Doe",
"email": "[email protected]"
}'
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-session-token" \
-d '{
"id": 123,
"name": "John Doe",
"email": "[email protected]"
}'
File Operations
ANY
/api/v1/files/list
List all files.
Request
curl -X GET https://api.appclust.com/api/v1/files/list \
-H "Content-Type: application/json"
-H "Content-Type: application/json"
Users
POST
/api/v1/users
Create a new user in the system.
Request
curl -X POST https://api.appclust.com/api/v1/users \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active"
}'
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active"
}'
Response
{
"success": true,
"data": {
"id": 123,
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
}
"success": true,
"data": {
"id": 123,
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
}
GET
/api/v1/users/{id}
Get user details by ID.
Request
curl -X GET https://api.appclust.com/api/v1/users/123 \
-H "Authorization: Bearer your-token"
-H "Authorization: Bearer your-token"
Response
{
"success": true,
"data": {
"id": 123,
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active",
"last_login": "2024-03-20T10:00:00Z"
}
}
"success": true,
"data": {
"id": 123,
"name": "John Doe",
"email": "[email protected]",
"role": "user",
"status": "active",
"last_login": "2024-03-20T10:00:00Z"
}
}
Apps
GET
/api/v1/apps
Get list of all applications with pagination support.
Request
curl -X GET https://api.appclust.com/api/v1/apps \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"page": 1,
"per_page": 10,
"sort_by": "name",
"sort_order": "asc"
}'
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"page": 1,
"per_page": 10,
"sort_by": "name",
"sort_order": "asc"
}'
Response
{
"success": true,
"data": {
"apps": [
{
"id": 1,
"name": "App 1",
"version": "1.0.0",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
],
"pagination": {
"total": 100,
"per_page": 10,
"current_page": 1,
"last_page": 10
}
}
}
"success": true,
"data": {
"apps": [
{
"id": 1,
"name": "App 1",
"version": "1.0.0",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
],
"pagination": {
"total": 100,
"per_page": 10,
"current_page": 1,
"last_page": 10
}
}
}
POST
/api/v1/apps
Create a new application.
Request
curl -X POST https://api.appclust.com/api/v1/apps \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"name": "New App",
"description": "App description",
"platform": "web",
"version": "1.0.0"
}'
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"name": "New App",
"description": "App description",
"platform": "web",
"version": "1.0.0"
}'
Response
{
"success": true,
"data": {
"id": 101,
"name": "New App",
"description": "App description",
"platform": "web",
"version": "1.0.0",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
}
"success": true,
"data": {
"id": 101,
"name": "New App",
"description": "App description",
"platform": "web",
"version": "1.0.0",
"status": "active",
"created_at": "2024-03-20T10:00:00Z"
}
}
Analytics
GET
/api/v1/analytics
Get comprehensive analytics data for your applications.
Request
curl -X GET https://api.appclust.com/api/v1/analytics \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"app_id": 1,
"start_date": "2024-03-01",
"end_date": "2024-03-20",
"metrics": ["users", "sessions", "pageviews"]
}'
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"app_id": 1,
"start_date": "2024-03-01",
"end_date": "2024-03-20",
"metrics": ["users", "sessions", "pageviews"]
}'
Response
{
"success": true,
"data": {
"app_id": 1,
"period": {
"start": "2024-03-01",
"end": "2024-03-20"
},
"metrics": {
"users": 1000,
"sessions": 5000,
"pageviews": 25000
},
"trends": {
"users": "+15%",
"sessions": "+20%",
"pageviews": "+25%"
}
}
}
"success": true,
"data": {
"app_id": 1,
"period": {
"start": "2024-03-01",
"end": "2024-03-20"
},
"metrics": {
"users": 1000,
"sessions": 5000,
"pageviews": 25000
},
"trends": {
"users": "+15%",
"sessions": "+20%",
"pageviews": "+25%"
}
}
}
GET
/api/v1/analytics/realtime
Get real-time analytics data for your applications.
Request
curl -X GET https://api.appclust.com/api/v1/analytics/realtime \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"app_id": 1,
"metrics": ["active_users", "concurrent_sessions"]
}'
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{
"app_id": 1,
"metrics": ["active_users", "concurrent_sessions"]
}'
Response
{
"success": true,
"data": {
"app_id": 1,
"timestamp": "2024-03-20T10:00:00Z",
"metrics": {
"active_users": 150,
"concurrent_sessions": 200
}
}
}
"success": true,
"data": {
"app_id": 1,
"timestamp": "2024-03-20T10:00:00Z",
"metrics": {
"active_users": 150,
"concurrent_sessions": 200
}
}
}