FlashCom APK Builder API - Convert Websites to Android APKs

API Overview

Comprehensive documentation for FlashCom APK Builder REST API with examples and best practices.

3

API Endpoints

15

Daily APKs Global

2

APKs Per User

5

Max Admins Per ID

Try Telegram Bot

Quick Start Guide

Get started in minutes with our simple REST API. Convert any website to Android APK with just a few API calls. All endpoints support JSON and require proper authentication.

Fast APK Generation

Convert websites to Android APK files instantly with our powerful generation endpoint. Supports custom icons, package names, and app names.

Quick build process

Real-time Build Status

Monitor your APK builds with comprehensive status tracking. Get detailed build logs and download links when your APK is ready.

Live progress updates

Easy Integration

Simple REST API with clear documentation. Easy to integrate with your existing applications and workflows.

Developer friendly

Standard Encryption

AES-256-CBC encryption for all sensitive data including bot tokens and API keys

Secure Authentication

Secret key-based authentication with Telegram ID verification for all users

Advanced Rate Limiting

Multi-layer rate limiting with per-user, per-admin, and global limits

Domain Protection

Blocked domains protection and HTTPS enforcement for security

Important Requirements

• All Telegram IDs must be numeric values
• Package names must follow Android naming conventions (com.example.app)
• Website URLs must use HTTPS protocol only
• Icons must be hosted on FlashCom Cloud
• Maximum 2 APKs per user per day
• Maximum 2 active builds per user concurrently

Generate APK

Convert websites to Android APK files with basic customization: app name, package name, and icon.

POST

https://flashcomapi.alwaysdata.net/api/generate-apk

Essential Requirements

All Telegram IDs must be numeric values. Package names must follow Android naming conventions. Website URLs must use HTTPS protocol only.

Required Parameters

app_name Application name (Max 50 characters)
package_name Android package format (com.example.app)
website_url HTTPS website URL only
telegram_id Numeric user ID (Required verification)
email Valid email address for build notifications
dev_telegram_id Pre-registered developer admin ID
bot_id Bot ID for build notifications (if dev admin is properly configured)

Optional Parameters

icon_url App icon URL (must be hosted on FlashCom Cloud - Use our telegram upload bot to host your icons)
return_url Return URL (Max 150 characters - After verification, users see a button in Telegram bot that redirects to this URL)

POST Request - Generate APK

{
  "app_name": "My Awesome Mobile App",
  "package_name": "com.example.myapp",
  "website_url": "https://example.com",
  "telegram_id": "123456789",
  "email": "developer@example.com",
  "dev_telegram_id": "6241607559",
  "icon_url": "https://flashcomcloud.alwaysdata.net/icon.png",
  "return_url": "https://myapp.com/build-callback",
  "bot_id": "987654321"
}
                        

Generate APK - Errors

Missing Required Fields
All required parameters must be provided: app_name, package_name, website_url, telegram_id, email, dev_telegram_id
Invalid Package Name Format
Package name must follow pattern: com.example.app (only lowercase letters, numbers, and dots allowed)
Non-HTTPS Website URL
Only HTTPS websites are supported for security reasons.
Invalid Telegram ID Format
Telegram IDs must be numeric values only.
Daily Build Limit Exceeded
Maximum 2 APKs per day per user.
Package Name Already Exists
This package name is already in use by another user.
Active Build in Progress
You already have 2 active builds in progress. Maximum 2 concurrent builds allowed.
Invalid Icon URL
Icons must be hosted on FlashCom Cloud. Use https://t.me/UpLynkBot to upload and get direct links. Only .jpg, .jpeg, .png files allowed.
Dev Admin Not Found
The provided dev_telegram_id is not registered. Please register admin first using manageDev API.
Rate Limit Exceeded
Too many requests. Please wait 15 minutes.
App Name Too Long
App name must be maximum 50 characters long.
Package Name Too Long
Package name must be maximum 100 characters long.
Invalid Email Format
Email must be in valid format (user@example.com).
Blocked Domain Detected
Websites hosted on blocked domains are not allowed.
Telegram ID Not Verified
Telegram ID must be verified via FlashComApkBuilderVerifierBot before generating APKs.
Global Daily Limit Reached
Daily global build limit reached. Try again tomorrow.
Website Not Accessible
Website is not accessible or unreachable. Please check if the website is online.
Website Returned Error
Website returned error code 4xx/5xx. Please ensure your website is working properly.
Website Non-Success Status
Website returned non-success status. Please ensure your website is accessible.
Invalid Icon Extension
Icon URL must end with .jpg, .jpeg, or .png extension.
Invalid Icon Domain
Icons must be hosted on FlashCom Cloud.
Icon Not Accessible
Icon URL not accessible or returned non-200 status.
Invalid Icon Format
Only PNG and JPG icons are allowed.
Icon File Too Large
Icon file too large (max 20MB).
Admin Verification Failed
The provided Dev Telegram ID could not be verified. Please make sure you have started the verification bot.
Server Temporarily Unavailable
Server is temporarily unavailable. Please try again later.
Internal Server Error
Internal server error occurred. Please try again.

Dev Admin Management

Register and manage developer administrators with secure authentication and Telegram verification.

POST

https://flashcomapi.alwaysdata.net/api/manageDev

Security & Verification

All bot tokens are encrypted using AES-256 encryption. Dev Telegram IDs must be verified through Telegram API. Keep your secret keys secure and never expose them in client-side code.

Register New Developer Admin

Required Parameters

dev_telegram_id Numeric developer admin ID (must be verified via Telegram)
platform Platform name (e.g., telegram)
bot_token_telegram Bot token for the platform
bot_id Bot ID for notifications (must be numeric)

POST Request - Registration

{
  "dev_telegram_id": "123456789",
  "platform": "telegram",
  "bot_token_telegram": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
  "bot_id": "123456789"
}
                            

Update Developer Admin Details

Required Parameters

secret Your secret key for authentication
dev_telegram_id Developer admin ID to update
action Must be "update"

Update Parameters (at least one required)

platform New platform name
bot_id New bot ID (must be numeric)
bot_token_telegram New bot token

Important Note

You must provide at least one update parameter (platform, bot_id, bot_token_telegram, or type) for the update to succeed.

POST Request - Update

{
  "secret": "sk-13ea83d472643808cee6f7ff5906b3c1",
  "dev_telegram_id": "123456789",
  "action": "update",
  "platform": "whatsapp",
  "bot_id": "987654321"
}
                            

Update with Bot Token Only

{
  "secret": "sk-13ea83d472643808cee6f7ff5906b3c1",
  "dev_telegram_id": "123456789",
  "action": "update",
  "bot_token_telegram": "123456:NEW-TOKEN-here123456789"
}
                            

Generate New Secret Key

Required Parameters

secret Your current secret key
dev_telegram_id Developer admin ID
action Must be "update"
type Must be "secret_new"

POST Request - Secret Rotation

{
  "secret": "sk-13ea83d472643808cee6f7ff5906b3c1",
  "dev_telegram_id": "123456789",
  "action": "update",
  "type": "secret_new"
}
                            

Delete Developer Admin

Required Parameters

secret Your secret key for authentication
dev_telegram_id Developer admin ID to delete
action Must be "delete"

POST Request - Deletion

{
  "secret": "sk-13ea83d472643808cee6f7ff5906b3c1",
  "dev_telegram_id": "123456789",
  "action": "delete"
}
                            

Change Developer Telegram ID

Required Parameters

secret Your secret key for authentication
dev_telegram_id Current developer admin ID
action Must be "change"
new_dev_telegram_id New Telegram ID (must be verified, numeric, and not exist)

POST Request - Change Telegram ID

{
  "secret": "sk-13ea83d472643808cee6f7ff5906b3c1",
  "dev_telegram_id": "123456789",
  "action": "change",
  "new_dev_telegram_id": "987654321"
}
                            

Dev Admin Management - Errors

Invalid Secret Key Format
Secret key must follow pattern: sk-[32 character hex string]
Secret/Telegram ID Mismatch
The provided secret key does not match the dev_telegram_id.
Invalid Action
Action must be one of: update, delete, change
Dev Admin Not Found
The specified developer admin does not exist.
Bot Token Already Registered
This bot token is already registered with another admin.
Bot ID Already Registered
This bot ID is already registered with another admin.
Daily Registration Limit
Maximum 200 dev admin registrations per day globally reached.
Max Admins Per Telegram ID
Maximum 5 dev admin registrations per Telegram ID reached.
Telegram Verification Failed
Dev Telegram ID could not be verified through Telegram API.
Rate Limit Exceeded
Too many dev admin requests. Please wait 10 minutes.
Missing Required Fields
Both secret and dev_telegram_id are required for management operations.
Invalid DevTelegramId Format
DevTelegramId must be numeric values only.
Invalid BotIdTelegram Format
BotIdTelegram must be numeric values only.
No Changes Detected
Update operation requires at least one field to modify.
NewDevTelegramId Already Exists
The new Telegram ID you're trying to change to is already registered.
Same Telegram ID
NewDevTelegramId must be different from current DevTelegramId.
NewDevTelegramId Verification Failed
The new Dev Telegram ID could not be verified through Telegram API.
Database Connection Failed
Unable to connect to the database. Please try again later.
Invalid JSON Input
The request body must contain valid JSON format.
Missing Registration Fields
Registration requires: dev_telegram_id, platform, bot_token_telegram, bot_id

APK Results & Status

Retrieve comprehensive build status, download links, and detailed build logs.

GET

https://flashcomapi.alwaysdata.net/api/apk-result

Real-time Build Monitoring

Use filters to efficiently query specific builds or time periods. All results include timestamps and status indicators.

Required Parameters

telegram_id Numeric user ID to fetch builds for

Optional Parameters

filter Results filter: latest, today, yesterday, all (default: latest)

GET Request - APK Results

GET https://flashcomapi.alwaysdata.net/api/apk-result
?telegram_id=123456789&filter=latest
                        

APK Results - Errors

Missing Telegram ID
Telegram ID parameter is required for all requests.
Invalid Filter Parameter
Filter must be one of: latest, today, yesterday, all
No Results Found
No APK results found for the specified Telegram ID and filter.
Global Rate Limit Exceeded
Global rate limit of 100 requests per minute exceeded. Locked for 2 minutes.
User Rate Limit Exceeded (30s)
User rate limit of 20 requests per 30 seconds exceeded. Locked for 1 minute.
User Rate Limit Exceeded (1m)
User limit of 100 requests per minute exceeded. Locked for 1 hour.
Database Connection Error
Unable to connect to the database. Please try again later.
Invalid Telegram ID Format
Telegram ID must be numeric values only.
Internal Server Error
An unexpected error occurred. Please try again later.

Response Fields

buildStatus queued, building, completed, failed
apkUrl Download link (only when buildStatus = completed)
logMessage Detailed build logs and error messages

Filter Options

latest Most recent build only (default)
today All builds from today
yesterday All builds from yesterday
all All builds (chronological order)

Rate Limits & Quotas

Comprehensive rate limiting and usage quotas to ensure system stability and fair usage.

Rate Limit Enforcement

Exceeding rate limits will result in temporary service locks. Implement proper error handling and exponential backoff in your applications. Specific limits are enforced per user, per admin, and globally.

User Tier Limits

Limited APKs per day maximum 2
Rate limited requests per minute
Maximum 2 concurrent active builds
Temporary lock for violations
Daily reset at 00:00 UTC

Developer Admin Limits

Higher request limits per minute
Daily request quotas enforced
Limited registrations per account
Temporary lock for violations
Higher quotas available

Global System Limits

System-wide APK daily limits
Global request rate limiting
Daily registration system limits
API result calls rate limited
System protection active

Rate Limit

Rate limits are enforced with clear error messages. When limits are exceeded, you'll receive detailed error responses with retry timing information.

Fair Usage Policy

Respect rate limits to ensure service stability. Violations result in temporary locks, with review for repeated abuse.

FlashCom APK Builder

Navigation

Quick Start Guide

Fast APK Generation

Real-time Build Status

Easy Integration

Standard Encryption

Secure Authentication

Advanced Rate Limiting

Domain Protection

Important Requirements

Essential Requirements

Required Parameters

Optional Parameters

Generate APK - Errors

Security & Verification

Register New Developer Admin

Required Parameters

Update Developer Admin Details

Required Parameters

Update Parameters (at least one required)

Important Note

Generate New Secret Key

Required Parameters

Delete Developer Admin

Required Parameters

Change Developer Telegram ID

Required Parameters

Dev Admin Management - Errors

Real-time Build Monitoring

Required Parameters

Optional Parameters

APK Results - Errors

Response Fields

Filter Options

Rate Limit Enforcement

User Tier Limits

Developer Admin Limits

Global System Limits

Rate Limit

Fair Usage Policy

FlashCom APK Builder