शक्तिशाली & आसान REST API
इंटीग्रेट करें, ऑटोमेट करें और भरोसे के साथ डिलीवर करें।
अपने कोड से SMS भेजें, स्पूफ़ कॉल करें, अपना बैलेंस जाँचें और लाइव कीमतें पाएँ। पाँच एंडपॉइंट, एक key, JSON इन और आउट — आपके डैशबोर्ड जैसी ही कीमतें और बैलेंस।
API प्लेग्राउंड
रिक्वेस्ट
curl https://app.spoofcallerid.com/v1/me \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl https://app.spoofcallerid.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl https://app.spoofcallerid.com/v1/prices?type=all \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'curl -X POST https://app.spoofcallerid.com/v1/calls \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"caller_id": "+18005550199",
"to_country": "GB",
"record": false
}'curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'रिस्पॉन्स
{
"id": 1042,
"username": "you",
"email": "[email protected]",
"balance": 25.5,
"currency": "EUR",
"status": "active"
}{
"balance": 25.5,
"currency": "EUR"
}{
"success": true,
"type": "all",
"count": 200,
"cached_ttl": 3600,
"data": [
{
"country": "United Kingdom",
"iso": "GB",
"prefix": "44",
"call": 0.1,
"call_initblock": 1,
"call_billingblock": 1,
"call_tiers": [
{
"rate": 0.1,
"routes": 1
},
{
"rate": 0.4,
"routes": 1
},
{
"rate": 0.85,
"routes": 1
}
],
"sms": 0.0906,
"sms_routes": [
{
"name": "Route 1",
"rate": 0.0906
},
{
"name": "Route 2",
"rate": 0.0924
}
],
"hlr": null,
"currency": "EUR"
}
]
}{
"success": true,
"message": "SMS sent successfully.",
"data": {
"cost": 0.0906,
"newBalance": 25.4094,
"segments": 1,
"encoding": "gsm7",
"route": "",
"batchId": "7f3c2a91"
}
}{
"success": true,
"message": "Call placed successfully.",
"data": {
"id": 318,
"status": "dialing",
"cost": 0.5,
"newBalance": 25.0,
"currentBalance": 25.0,
"estimatedMinutes": 5,
"toNumber": "+447700900123",
"displayNumber": "+18005550199",
"ami_ref": "spoof_1042_1763190000"
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}ज़रूरी सुरक्षा सूचना
अपनी API key और secret गोपनीय रखें। इनका इस्तेमाल सिर्फ़ अपने सर्वर से करें, कभी भी क्लाइंट-साइड कोड में नहीं। अगर ये लीक हो जाएँ, तो Account → API & keys में इन्हें दोबारा जनरेट करें — पुरानी जोड़ी तुरंत काम करना बंद कर देती है।
ऑथेंटिकेशन
Bearerहर रिक्वेस्ट में आपकी key और secret एक ही हेडर में, कोलन से अलग करके भेजे जाते हैं। रिक्वेस्ट और रिस्पॉन्स HTTPS पर JSON में होते हैं।
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET
बेस URL: https://app.spoofcallerid.com/v1
अकाउंट प्राप्त करें
GET /v1/me
key के मालिक अकाउंट को लौटाता है: id, username, email, balance और status।
curl https://app.spoofcallerid.com/v1/me \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"id": 1042,
"username": "you",
"email": "[email protected]",
"balance": 25.5,
"currency": "EUR",
"status": "active"
}बैलेंस प्राप्त करें
GET /v1/balance
यूरो में आपका मौजूदा बैलेंस। कॉल करना सस्ता है — बड़ी संख्या में भेजने से पहले इसका इस्तेमाल करें।
curl https://app.spoofcallerid.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"balance": 25.5,
"currency": "EUR"
}कीमतें प्राप्त करें
GET /v1/prices
हर गंतव्य के लिए लाइव कॉल और SMS कीमतें, वही लिस्ट जो Coverage & Prices में है। एक घंटे के लिए कैश की जाती है।
पैरामीटर:
type: वैकल्पिक।all(डिफ़ॉल्ट),smsयाvoice।
curl https://app.spoofcallerid.com/v1/prices?type=all \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"success": true,
"type": "all",
"count": 200,
"cached_ttl": 3600,
"data": [
{
"country": "United Kingdom",
"iso": "GB",
"prefix": "44",
"call": 0.1,
"call_initblock": 1,
"call_billingblock": 1,
"call_tiers": [
{
"rate": 0.1,
"routes": 1
},
{
"rate": 0.4,
"routes": 1
},
{
"rate": 0.85,
"routes": 1
}
],
"sms": 0.0906,
"sms_routes": [
{
"name": "Route 1",
"rate": 0.0906
},
{
"name": "Route 2",
"rate": 0.0924
}
],
"hlr": null,
"currency": "EUR"
}
]
}SMS भेजें
POST /v1/sms
आपकी चुनी हुई Sender ID के साथ एक SMS भेजता है और हर मैसेज सेगमेंट के हिसाब से आपके बैलेंस से शुल्क लेता है।
पैरामीटर:
to: ज़रूरी। देश कोड के साथ प्राप्तकर्ता का नंबर, जैसे+447700900123।text: ज़रूरी। मैसेज टेक्स्ट, अधिकतम 160 कैरेक्टर।sender_id: ज़रूरी। सेंडर के रूप में दिखने वाला नाम या नंबर, 1–20 अक्षर या अंक।country: वैकल्पिक। ISO देश कोड (जैसेGB), जबtoमें देश कोड न हो।route: वैकल्पिक। गंतव्य के लिए कोई ख़ास रूट; डिफ़ॉल्ट रूप से सबसे सस्ता रूट इस्तेमाल होता है।
curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'{
"success": true,
"message": "SMS sent successfully.",
"data": {
"cost": 0.0906,
"newBalance": 25.4094,
"segments": 1,
"encoding": "gsm7",
"route": "",
"batchId": "7f3c2a91"
}
}स्पूफ़ कॉल करें
POST /v1/calls
आपकी चुनी हुई Caller ID दिखाने वाली कॉल करता है। कॉल शुरू होते ही अनुमानित लागत आपके बैलेंस से रिज़र्व कर ली जाती है।
पैरामीटर:
to: ज़रूरी। कॉल करने का नंबर, अंतरराष्ट्रीय फ़ॉर्मेट में याto_countryके साथ लोकल फ़ॉर्मेट में।caller_id: ज़रूरी। वह नंबर जो कॉल पाने वाले व्यक्ति को दिखेगा।to_country: वैकल्पिक।toका ISO देश, जैसेGB।caller_country: वैकल्पिक।caller_idका ISO देश।record: वैकल्पिक। कॉल रिकॉर्ड करने के लिएtrue। डिफ़ॉल्टfalse।plan: वैकल्पिक। कॉल प्लान आईडी। हर प्लान अपनी दर और अंतराल से बिल करता है; डिफ़ॉल्ट Worldwide है।
curl -X POST https://app.spoofcallerid.com/v1/calls \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"caller_id": "+18005550199",
"to_country": "GB",
"record": false
}'{
"success": true,
"message": "Call placed successfully.",
"data": {
"id": 318,
"status": "dialing",
"cost": 0.5,
"newBalance": 25.0,
"currentBalance": 25.0,
"estimatedMinutes": 5,
"toNumber": "+447700900123",
"displayNumber": "+18005550199",
"ami_ref": "spoof_1042_1763190000"
}
}एरर
4xx / 5xxहर विफलता पर नीचे दिया गया HTTP स्टेटस और एक JSON बॉडी लौटती है, जिसमें एक स्थिर error.code होता है जिसके आधार पर आप ब्रांच कर सकते हैं।
invalid_request400 — बॉडी मान्य JSON नहीं है या किसी फ़ील्ड का टाइप गलत है।unauthorized401 — Authorization हेडर मौजूद नहीं है, गलत फ़ॉर्मेट में है, या key/secret गलत है।insufficient_balance402 — आपका बैलेंस लागत के लिए पर्याप्त नहीं है।error.detailsमें लागत और बैलेंस होता है।not_found404 — ऐसा कोई एंडपॉइंट नहीं है। पाथ और/v1प्रीफ़िक्स जाँचें।method_not_allowed405 — गलत HTTP मेथड;Allowहेडर सही मेथड बताता है।validation_failed422 — कोई फ़ील्ड मौजूद नहीं है या अमान्य है;error.messageबताता है कि कौन-सा।internal_error500 — हमारी तरफ़ कुछ गड़बड़ हुई। दोबारा कोशिश करें, फिर सपोर्ट से संपर्क करें।provider_rejected502 — कैरियर ने मैसेज या कॉल अस्वीकार कर दी; कोई शुल्क नहीं लगा।service_unavailable503 — कोई डिपेंडेंसी अस्थायी रूप से बंद है। बैकऑफ़ के साथ दोबारा कोशिश करें।
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}
अपना AI असिस्टेंट जोड़ें (MCP)
5 toolsSpoofcallerid MCP सर्वर हर एंडपॉइंट को Claude या किसी भी MCP क्लाइंट के लिए एक टूल में बदल देता है: get_account, get_balance, get_prices, send_sms और make_spoof_call। एक फ़ाइल, कोई डिपेंडेंसी नहीं, Node.js 18+। बैलेंस खर्च करने वाले दोनों टूल पहले पुष्टि माँगते हैं।
MCP सर्वर डाउनलोड करें · JSON मैनिफ़ेस्ट
{
"mcpServers": {
"spoofcallerid": {
"command": "node",
"args": [
"/path/to/spoofcallerid-mcp.mjs"
],
"env": {
"SPOOFCALLERID_API_KEY": "YOUR_API_KEY:YOUR_API_SECRET"
}
}
}
}
अक्सर पूछे जाने वाले सवाल
मुझे अपनी API key कहाँ मिलेगी?
मैं ऑथेंटिकेट कैसे करूँ?
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET भेजें। secret को अपने सर्वर पर रखें — कभी भी ब्राउज़र या मोबाइल ऐप में नहीं।एक रिक्वेस्ट की कीमत कितनी है?
POST /v1/sms और POST /v1/calls पर वही कीमतें लगती हैं जो डैशबोर्ड पर हैं, जो Coverage & Prices में और GET /v1/prices में दिखाई जाती हैं।