शक्तिशाली & आसान 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_request 400 — बॉडी मान्य JSON नहीं है या किसी फ़ील्ड का टाइप गलत है।
  • unauthorized 401 — Authorization हेडर मौजूद नहीं है, गलत फ़ॉर्मेट में है, या key/secret गलत है।
  • insufficient_balance 402 — आपका बैलेंस लागत के लिए पर्याप्त नहीं है। error.details में लागत और बैलेंस होता है।
  • not_found 404 — ऐसा कोई एंडपॉइंट नहीं है। पाथ और /v1 प्रीफ़िक्स जाँचें।
  • method_not_allowed 405 — गलत HTTP मेथड; Allow हेडर सही मेथड बताता है।
  • validation_failed 422 — कोई फ़ील्ड मौजूद नहीं है या अमान्य है; error.message बताता है कि कौन-सा।
  • internal_error 500 — हमारी तरफ़ कुछ गड़बड़ हुई। दोबारा कोशिश करें, फिर सपोर्ट से संपर्क करें।
  • provider_rejected 502 — कैरियर ने मैसेज या कॉल अस्वीकार कर दी; कोई शुल्क नहीं लगा।
  • service_unavailable 503 — कोई डिपेंडेंसी अस्थायी रूप से बंद है। बैकऑफ़ के साथ दोबारा कोशिश करें।
{
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient balance.",
        "details": {
            "cost": 0.0906,
            "balance": 0.02
        }
    }
}
अपना AI असिस्टेंट जोड़ें (MCP)
5 tools

Spoofcallerid 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 कहाँ मिलेगी?
डैशबोर्ड में साइन इन करें और Account → API & keys खोलें। दोबारा जनरेट करने पर नई key और secret बनते हैं; secret सिर्फ़ एक बार दिखाया जाता है और पुरानी जोड़ी तुरंत काम करना बंद कर देती है।
मैं ऑथेंटिकेट कैसे करूँ?
हर रिक्वेस्ट के साथ Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET भेजें। secret को अपने सर्वर पर रखें — कभी भी ब्राउज़र या मोबाइल ऐप में नहीं।
एक रिक्वेस्ट की कीमत कितनी है?
अपना अकाउंट, बैलेंस और कीमतें पढ़ना मुफ़्त है। POST /v1/sms और POST /v1/calls पर वही कीमतें लगती हैं जो डैशबोर्ड पर हैं, जो Coverage & Prices में और GET /v1/prices में दिखाई जाती हैं।
एक SMS कितना लंबा हो सकता है?
हर रिक्वेस्ट में अधिकतम 160 कैरेक्टर। GSM-7 टेक्स्ट के 160 कैरेक्टर एक सेगमेंट में आते हैं; इमोजी या गैर-लैटिन अक्षर होने पर Unicode लागू होता है, जिसमें प्रति सेगमेंट 70 कैरेक्टर आते हैं, और हर सेगमेंट का शुल्क लगता है।
क्या कोई AI असिस्टेंट API का इस्तेमाल कर सकता है?
हाँ। Spoofcallerid MCP सर्वर डाउनलोड करें, उसे अपनी key दें, और Claude या कोई भी MCP क्लाइंट आपका बैलेंस और कीमतें जाँच सकता है, SMS भेज सकता है और कॉल कर सकता है। पैसे खर्च करने वाले टूल पहले पुष्टि माँगते हैं।