API DOCUMENTATION

Comprehensive guide for integrating with TELE STORA API. Access all endpoints with secure authentication.

Test API Live Integration Examples

Authentication

All API requests require authentication using your API key. Include it in the Authorization header.

Header Authorization: Bearer YOUR_API_KEY
Header Example 
Authorization: Bearer sk_live_1234567890abcdef

How to get your API key:

  1. Open the Telegram bot
  2. Go to the "🔑 API Access" menu
  3. Copy your API key
  4. Use it in the Authorization header

Get User Information

Retrieve authenticated user information including balance.

GET /api/user/balance
Request Example 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://tele-stora.com/api/user/balance

Response Example 

{
  "user_id": 123456789,
  "username": "johndoe",
  "balance": 150.50,
  "currency": "USD"
}

Get Available Countries

Retrieve a list of available countries with prices.

GET /api/countries/available
Request Example 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://tele-stora.com/api/countries/available

Response Example 

{
  "user_id": 123456789,
  "available_countries": [
    {
      "country_code": "US",
      "country_name": "United States",
      "flag_emoji": "🇺🇸",
      "base_price": 2.5,
      "user_price": 2.3
    }
  ],
  "total_countries": 25
}

Purchase Account

Purchase a Telegram account from a specific country.

POST /api/purchase/start

Request Body

{
  "country_code": "US"
}
Request Example 
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code": "US"}' \
  https://tele-stora.com/api/purchase/start

Success Response 

{
  "status": "success",
  "message": "Account reserved successfully",
  "purchase_id": "123456_1620000000",
  "phone": "+1234567890",
  "price": 2.3,
  "next_step": "complete_purchase"
}

Error Response 

{
  "status": "error",
  "message": "Insufficient balance"
}

Complete Purchase

Complete the purchase process - get activation code, deduct balance, and finalize.

POST /api/purchase/complete

Request Body

{
  "purchase_id": "123456_1620000000"
}
Request Example 
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchase_id": "123456_1620000000"}' \
  https://tele-stora.com/api/purchase/complete

Success Response 

{
  "status": "success",
  "message": "Purchase completed successfully",
  "phone": "+1234567890",
  "session_string": "1aaNk8...",
  "activation_code": "12345",
  "two_fa_password": null,
  "price": 2.3,
  "remaining_balance": 148.2
}

What happens in this step:

  • Get activation code automatically from messages
  • Deduct balance from user account
  • Disable two-step verification if enabled
  • Log out from the account
  • Record transaction in database
  • Send notifications to channels

Test API

Test the API endpoints directly from this interface

Processing request...

Response

Integration Example

Here's a complete example of how to integrate with our API:

Python Example 
import requests

class TelegramAccountAPI:
    def __init__(self, api_key, base_url="https://tele-stora.com/"):
        self.api_key = api_key
        self.base_url = base_url
        self.headers = {"Authorization": f"Bearer {api_key}"}
    
    def get_user_info(self):
        response = requests.get(
            f"{self.base_url}/api/user/balance",
            headers=self.headers
        )
        return response.json()
    
    def get_countries(self):
        response = requests.get(
            f"{self.base_url}/api/countries/available",
            headers=self.headers
        )
        return response.json()
    
    def purchase_account(self, country_code):
        data = {"country_code": country_code}
        response = requests.post(
            f"{self.base_url}/api/purchase/start",
            headers=self.headers,
            json=data
        )
        return response.json()
    
    def complete_purchase(self, purchase_id):
        data = {"purchase_id": purchase_id}
        response = requests.post(
            f"{self.base_url}/api/purchase/complete",
            headers=self.headers,
            json=data
        )
        return response.json()

# Usage example
api = TelegramAccountAPI("your_api_key_here")

# Get user balance
user_info = api.get_user_info()
print(f"Balance: {user_info['balance']}")

# Get available countries
countries = api.get_countries()
print(f"Available countries: {len(countries['available_countries'])}")

# Purchase an account
purchase = api.purchase_account("US")
if purchase["status"] == "success":
    print(f"Account reserved: {purchase['phone']}")
    
    # Complete purchase
    completion = api.complete_purchase(purchase["purchase_id"])
    if completion["status"] == "success":
        print(f"Account purchased! Activation code: {completion['activation_code']}")