डेवलपर API
सार्वजनिक API एक ही एंडपॉइंट और सिर्फ़ GET अनुरोध है: मेथड का नाम action पैरामीटर में जाता है। फ़ॉर्मेट लोकप्रिय प्लेटफ़ॉर्मों जैसा है, इसलिए मौजूदा कोड सिर्फ़ बेस URL बदलने पर चलने लगता है।
एक्सेस कीकी लें
की आपके अकाउंट में बनती है — इसे पाने के लिए लॉग इन या साइन अप करें।की की स्ट्रिंग सिर्फ़ एक बार दिखती है — बनाते समय। खो जाए तो नई बनाएँ और पुरानी रद्द करें।बेस URL
GEThttps://sim-aggregator.org/stubs/handler_api.php
सभी मेथड इसी पते पर बुलाए जाते हैं; सिर्फ़ action पैरामीटर बदलता है।काम का क्रम
1getPrices · getServicesListज़रूरी सेवा और देश की कीमत तथा उपलब्धता देखें।
2getNumber · getNumberV2नंबर ऑर्डर करें — जवाब में एक्टिवेशन id और नंबर आता है।
3getStatusकोड आने तक स्टेटस पूछते रहें।
4setStatus · 6सेवा द्वारा कोड स्वीकार होते ही एक्टिवेशन पूरी करें।
—setStatus · 3 · 8एक और कोड चाहिए — 3; नंबर काम न आया — 8, पैसा लौट आएगा।
मेथड सारांश
| मेथड | की | पैरामीटर |
|---|---|---|
| getPrices | की चाहिए | action, api_key, [country], [service] |
| getCountries | की चाहिए | action, api_key |
| getServicesList | की चाहिए | action, api_key, [country] |
| getBalance | की चाहिए | action, api_key |
| getNumber | की चाहिए | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getNumberV2 | की चाहिए | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getStatus | की चाहिए | action, api_key, id |
| getCurrentActivationsList | की चाहिए | action, api_key |
| setStatus | की चाहिए | action, api_key, id, status |
getPrices
की चाहिएदेश और सेवा के अनुसार कीमत और स्टॉक — कितने नंबर हैं और किस दाम पर।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getPrices |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| country | string | नहीं | देश का पहचानकर्ता, जैसे 43 |
| service | string | नहीं | सेवा का कोड, जैसे wa |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getPrices&api_key=YOUR_API_KEY&country=43
जवाब
{
"43": {
"wa": { "cost": 0.5, "count": 100 },
"tg": { "cost": 0.71, "count": 250 }
}
}क्या जवाब आ सकते हैं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
getCountries
की चाहिएदेशों की सूची: पहचानकर्ता, नाम और देश में कौन-से मोड उपलब्ध हैं।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getCountries |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCountries&api_key=YOUR_API_KEY
जवाब
{
"43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
"visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
getServicesList
की चाहिएसेवाओं की सूची: सेवा का कोड और उसका नाम।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getServicesList |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| country | string | नहीं | देश का पहचानकर्ता, जैसे 43 |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getServicesList&api_key=YOUR_API_KEY
जवाब
{
"status": "success",
"services": [
{ "code": "tg", "name": "Telegram" },
{ "code": "wa", "name": "WhatsApp" }
]
}क्या जवाब आ सकते हैं
BAD_COUNTRYदेश नहीं मिला
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
getBalance
की चाहिएखाते का बैलेंस।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getBalance |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getBalance&api_key=YOUR_API_KEY
जवाब
ACCESS_BALANCE:12.50
क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
getNumber
की चाहिएनंबर ऑर्डर करें। जवाब में एक्टिवेशन id और नंबर आता है।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getNumber |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| country | string | अनिवार्य | देश का पहचानकर्ता, जैसे 43 |
| service | string | अनिवार्य | सेवा का कोड, जैसे wa |
| duration | string | नहीं | ऑर्डर की अवधि: activation — एक बार का एक्टिवेशन (डिफ़ॉल्ट); d1, d3, d7 — नंबर 1, 3 या 7 दिन के लिए किराए पर |
| maxPrice | string | नहीं | प्रति नंबर अधिकतम कीमत। इससे महँगा नहीं खरीदेंगे: ऑर्डर की जगह WRONG_MAX_PRICE या NO_NUMBERS आएगा |
| softId | string | नहीं | सॉफ़्टवेयर पहचानकर्ता, 255 अक्षरों तक |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
जवाब
ACCESS_NUMBER:12345:380991234567
क्या जवाब आ सकते हैं
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_DURATIONduration का मान अज्ञात है
WRONG_MAX_PRICE:PRICEकीमत maxPrice से ज़्यादा है; कोलन के बाद इस जोड़ी की सबसे कम कीमत है (सिर्फ़ एक बार के एक्टिवेशन के लिए)
BAD_MAX_PRICEmaxPrice संख्या नहीं है या शून्य से बड़ा नहीं है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
BAD_SOFTWARE_IDsoftId ग़लत है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
getNumberV2
की चाहिएनंबर ऑर्डर करें — getNumber जैसा ही, लेकिन सफल जवाब JSON में आता है: कीमत, देश और एक्टिवेशन के समय के साथ।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getNumberV2 |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| country | string | अनिवार्य | देश का पहचानकर्ता, जैसे 43 |
| service | string | अनिवार्य | सेवा का कोड, जैसे wa |
| duration | string | नहीं | ऑर्डर की अवधि: activation — एक बार का एक्टिवेशन (डिफ़ॉल्ट); d1, d3, d7 — नंबर 1, 3 या 7 दिन के लिए किराए पर |
| maxPrice | string | नहीं | प्रति नंबर अधिकतम कीमत। इससे महँगा नहीं खरीदेंगे: ऑर्डर की जगह WRONG_MAX_PRICE या NO_NUMBERS आएगा |
| softId | string | नहीं | सॉफ़्टवेयर पहचानकर्ता, 255 अक्षरों तक |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
जवाब
{
"activationId": 12345,
"phoneNumber": "380991234567",
"activationCost": 0.50,
"currency": 840,
"countryCode": "43",
"canGetAnotherSms": "1",
"activationTime": "2026-07-31 12:00:00",
"activationOperator": "any"
}क्या जवाब आ सकते हैं
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_DURATIONduration का मान अज्ञात है
WRONG_MAX_PRICE:PRICEकीमत maxPrice से ज़्यादा है; कोलन के बाद इस जोड़ी की सबसे कम कीमत है (सिर्फ़ एक बार के एक्टिवेशन के लिए)
BAD_MAX_PRICEmaxPrice संख्या नहीं है या शून्य से बड़ा नहीं है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
BAD_SOFTWARE_IDsoftId ग़लत है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
getStatus
की चाहिएएक्टिवेशन का स्टेटस: कोड का इंतज़ार है या कोड आ चुका है।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getStatus |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| id | string | अनिवार्य | getNumber से मिला एक्टिवेशन id |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getStatus&api_key=YOUR_API_KEY&id=12345
जवाब
STATUS_OK:123456
क्या जवाब आ सकते हैं
STATUS_WAIT_CODEनंबर दे दिया गया, कोड अभी नहीं आया
STATUS_OK:CODEकोड मिल गया, अंत में SMS का कोड है
STATUS_WAIT_RETRY:CODEअगले कोड का इंतज़ार है; अंत में पिछला कोड है
STATUS_CANCELएक्टिवेशन पहले ही बंद है: रद्द या पूरा हो चुका है
NO_ACTIVATIONएक्टिवेशन नहीं मिली या पहले ही बंद है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
getCurrentActivationsList
की चाहिएइस कुंजी के सक्रिय ऑर्डर: वे नंबर जो अभी कोड का इंतज़ार कर रहे हैं या कोड पा चुके हैं।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: getCurrentActivationsList |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
जवाब
[
{
"numberid": 12345,
"number": "380991234567",
"status": 0
}
]क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
setStatus
की चाहिएएक्टिवेशन बदलें: एक और कोड माँगें, पूरी करें या रद्द करें।
पैरामीटर
| पैरामीटर | प्रकार | अनिवार्य | विवरण |
|---|---|---|---|
| action | string | अनिवार्य | मेथड का नाम: setStatus |
| api_key | string | अनिवार्य | पैनल से मिली एक्सेस की |
| id | string | अनिवार्य | getNumber से मिला एक्टिवेशन id |
| status | string | अनिवार्य | एक्टिवेशन की नई स्थिति: 3, 6 या 8 |
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
जवाब
ACCESS_ACTIVATION
status के मान
3उसी नंबर पर एक और कोड माँगें
6एक्टिवेशन पूरी करें: कोड स्वीकार हुआ
8एक्टिवेशन रद्द करें, पैसा बैलेंस में लौटेगा
क्या जवाब आ सकते हैं
ACCESS_ACTIVATIONएक्टिवेशन पूरी हुई
ACCESS_CANCELएक्टिवेशन रद्द हुई, पैसा लौट आया
ACCESS_RETRY_GETअनुरोध स्वीकार हुआ: इसी नंबर पर अगले कोड का इंतज़ार है
NO_ACTIVATIONएक्टिवेशन नहीं मिली या पहले ही बंद है
EARLY_CANCEL_DENIEDरद्द करने के लिए अभी जल्दी है — बाद में दोबारा कोशिश करें
BAD_STATUSअनुमति नहीं: सक्रियण पहले ही बंद है, या कोड दिया जा चुका है और रद्द नहीं किया जा सकता
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
सामान्य त्रुटियाँ
BAD_ACTIONaction में अज्ञात मेथड नाम
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
REQUEST_LIMITप्रति कुंजी अनुरोध सीमा पार हो गई — प्रतीक्षा करें और दोबारा प्रयास करें
BAD_SOFTWARE_IDsoftId ग़लत है
BAD_STATUSstatus का मान समर्थित नहीं
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
सेवा कोडपूरी सूची — getServicesList
waWhatsApp
tgTelegram
vkVK
goGoogle
fbFacebook
lfTikTok
igInstagram
dsDiscord
drOpenAI
aczClaude
देश कोडपूरी सूची — getCountries
43जर्मनी
15पोलैंड
16यूनाइटेड किंगडम
78फ़्रांस
86इटली
56स्पेन
2कज़ाखस्तान
62तुर्किये
187संयुक्त राज्य
22भारत
सीमाएँ
प्रति कुंजी अनुरोध600 प्रति मिनट (≈10 प्रति सेकंड)
स्टेटस पूछनाहर सक्रियण पर 2–5 सेकंड में एक बार