Supersim API
API v1 — stable
Build on Supersim.
The complete developer documentation for integrating the Supersim store into your applications. Fast, reliable, and scalable — with official examples in Python, PHP and JavaScript.
🧩
Three-Language Support
Ready-to-copy examples for Python, PHP, and JavaScript — every endpoint, every request.
🛡️
Secure by Default
Hashed API keys, per-key rate limiting, idempotent purchases, and ownership checks on every order.
🔗
Webhooks & Automation
Receive OTP and order updates in real time on your own endpoint — no polling required.
Your first request
Section titled “Your first request”Every request authenticates with your API key in the X-API-Key header. Here is how you check the live stock:
import requests
resp = requests.get( "https://su-persim.uz/api/v1/stock", headers={"X-API-Key": "supersim_YOUR_API_KEY"},)print(resp.status_code)print(resp.json())<?php
$ch = curl_init("https://su-persim.uz/api/v1/stock");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY",]);$response = curl_exec($ch);curl_close($ch);
echo $response;const res = await fetch("https://su-persim.uz/api/v1/stock", {headers: { "X-API-Key": "supersim_YOUR_API_KEY" },});const stock = await res.json();console.log(stock);Get your API key from the Telegram bot, then read the Getting Started guide.