Apps Endpoint

Manage apps programmatically - create, read, update, and delete apps.

Base Endpoint

https://api.tksmods.in/apps

List Apps

GET

Retrieve a paginated list of approved apps.

Public

Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
limit	integer	No	Items per page (max: 100, default: 20)
category	string	No	Filter by category slug
search	string	No	Search query
sort	string	No	Sort by: latest, popular, rating

Example Request

curl -X GET "https://api.tksmods.in/apps?page=1&limit=10&sort=popular"

Example Response

{
  "success": true,
  "message": "Apps retrieved successfully",
  "data": {
    "apps": [
      {
        "id": 1,
        "name": "Amazing App",
        "slug": "amazing-app",
        "description": "App description...",
        "developer_name": "John Doe",
        "category_name": "Games",
        "total_downloads": 5000,
        "average_rating": 4.5
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "per_page": 10
    }
  }
}

Get Single App

GET

Retrieve details of a specific app including reviews.

Public

Endpoint

https://api.tksmods.in/apps/{id}

Example Request

curl -X GET "https://api.tksmods.in/apps/123"

Create App

POST

Create a new app. Requires authentication.

Authentication Required

Request Body

Field	Type	Required	Description
name	string	Required	App name
description	string	Required	Full description
category_id	integer	Required	Category ID
short_description	string	No	Short description
version	string	No	App version (default: 1.0.0)
package_name	string	No	Package name (e.g., com.example.app)

Example Request

curl -X POST "https://api.tksmods.in/apps" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Awesome App",
    "description": "This is an amazing app that does great things",
    "short_description": "An amazing app",
    "category_id": 1,
    "version": "1.0.0",
    "package_name": "com.example.myapp"
  }'

Example Response

{
  "success": true,
  "message": "App created successfully. Awaiting admin approval.",
  "data": {
    "app_id": 123,
    "slug": "my-awesome-app",
    "status": "pending"
  }
}

Update App

PUT

Update an existing app. You must own the app.

Authentication Required

Endpoint

https://api.tksmods.in/apps/{id}

Example Request

curl -X PUT "https://api.tksmods.in/apps/123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated App Name",
    "description": "Updated description"
  }'

Delete App

DELETE

Delete an app. You must own the app.

Authentication Required

Endpoint

https://api.tksmods.in/apps/{id}

Example Request

curl -X DELETE "https://api.tksmods.in/apps/123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Note: All created apps start with "pending" status and require admin approval before they appear publicly.