Güçlü ve Basit REST API

Entegre Edin, Otomatikleştirin ve Güvenle Teslim Edin.

Kendi kodunuzdan SMS gönderin, spoof aramalar yapın, bakiyenizi kontrol edin ve canlı fiyatları alın. Beş uç nokta, tek anahtar, JSON giriş ve çıkış; panelinizle aynı fiyatlar ve aynı bakiye.

API Deneme Alanı

İSTEK

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"
  }'

YANIT

{
    "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
        }
    }
}
Önemli Güvenlik Uyarısı

API anahtarınızı ve gizli anahtarınızı kimseyle paylaşmayın. Bunları yalnızca sunucunuzda kullanın, asla istemci tarafı kodda kullanmayın. Sızdırılırlarsa Hesap → API & anahtarlar bölümünden yeniden oluşturun; eski çift anında çalışmayı durdurur.

Kimlik Doğrulama
Bearer

Her istek, anahtarınızı ve gizli anahtarınızı iki nokta üst üste ile ayrılmış şekilde tek bir başlıkta taşır. İstekler ve yanıtlar HTTPS üzerinden JSON biçimindedir.

Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET

Temel URL: https://app.spoofcallerid.com/v1

Hesabı Getir
GET /v1/me

Anahtarın sahibi olan hesabı döndürür: kimlik, kullanıcı adı, e-posta, bakiye ve durum.

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"
}
Bakiyeyi Getir
GET /v1/balance

Euro cinsinden mevcut bakiyeniz. Bu istek ucuzdur; büyük bir gönderimden önce kullanın.

curl https://app.spoofcallerid.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
{
    "balance": 25.5,
    "currency": "EUR"
}
Fiyatları Getir
GET /v1/prices

Her hedef için canlı arama ve SMS fiyatları; Kapsama & Fiyatlar sayfasındakiyle aynı liste. Bir saat boyunca önbellekte tutulur.

Parametreler:
  • type: İsteğe bağlı. all (varsayılan), sms veya 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 Gönderin
POST /v1/sms

Seçtiğiniz gönderen kimliğiyle tek bir SMS gönderir ve bakiyenizden mesaj segmenti başına ücret düşer.

Parametreler:
  • to: Zorunlu. Ülke kodunu içeren alıcı numarası, ör. +447700900123.
  • text: Zorunlu. Mesaj metni, en fazla 160 karakter.
  • sender_id: Zorunlu. Gönderen olarak gösterilen ad veya numara; 1–20 harf ya da rakam.
  • country: İsteğe bağlı. to alanında ülke kodu yoksa ISO ülke kodu (ör. GB).
  • route: İsteğe bağlı. Hedef için belirli bir rota; varsayılan olarak en ucuz rota kullanılır.
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"
    }
}
Spoof Arama Yapın
POST /v1/calls

Seçtiğiniz arayan kimliğini gösteren bir arama başlatır. Tahmini maliyet, arama başladığında bakiyenizden ayrılır.

Parametreler:
  • to: Zorunlu. Aranacak numara; uluslararası biçimde ya da to_country ile birlikte yerel biçimde.
  • caller_id: Zorunlu. Aradığınız kişinin göreceği numara.
  • to_country: İsteğe bağlı. to numarasının ISO ülke kodu, ör. GB.
  • caller_country: İsteğe bağlı. caller_id numarasının ISO ülke kodu.
  • record: İsteğe bağlı. Aramayı kaydetmek için true. Varsayılan: false.
  • plan: İsteğe bağlı. Arama planı kimliği. Her plan kendi ücreti ve adımıyla ücretlendirir; varsayılan 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"
    }
}
Hatalar
4xx / 5xx

Her hata, aşağıdaki HTTP durum kodunu ve kodunuzda koşul olarak kullanabileceğiniz sabit bir error.code içeren bir JSON gövdesi döndürür.

  • invalid_request 400 — Gövde geçerli bir JSON değil veya bir alanın türü yanlış.
  • unauthorized 401 — Authorization başlığı eksik veya hatalı biçimlendirilmiş ya da anahtar/gizli anahtar yanlış.
  • insufficient_balance 402 — Bakiyeniz maliyeti karşılamıyor. Maliyet ve bakiye error.details alanında yer alır.
  • not_found 404 — Böyle bir uç nokta yok. Yolu ve /v1 önekini kontrol edin.
  • method_not_allowed 405 — Yanlış HTTP yöntemi; doğru yöntemi Allow başlığı gösterir.
  • validation_failed 422 — Bir alan eksik veya geçersiz; hangisi olduğunu error.message belirtir.
  • internal_error 500 — Bizim tarafımızda bir hata oluştu. Yeniden deneyin, sorun sürerse destekle iletişime geçin.
  • provider_rejected 502 — Operatör mesajı veya aramayı reddetti; ücret alınmadı.
  • service_unavailable 503 — Bağlı bir hizmet geçici olarak kullanılamıyor. Artan bekleme süreleriyle yeniden deneyin.
{
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient balance.",
        "details": {
            "cost": 0.0906,
            "balance": 0.02
        }
    }
}
Yapay Zekâ Asistanınızı Bağlayın (MCP)
5 tools

Spoofcallerid MCP sunucusu her uç noktayı Claude veya herhangi bir MCP istemcisi için bir araca dönüştürür: get_account, get_balance, get_prices, send_sms ve make_spoof_call. Tek dosya, bağımlılık yok, Node.js 18+. Bakiye harcayan iki araç önce onay ister.

MCP sunucusunu indirin · JSON manifesti

{
    "mcpServers": {
        "spoofcallerid": {
            "command": "node",
            "args": [
                "/path/to/spoofcallerid-mcp.mjs"
            ],
            "env": {
                "SPOOFCALLERID_API_KEY": "YOUR_API_KEY:YOUR_API_SECRET"
            }
        }
    }
}

Sıkça Sorulan Sorular

API anahtarımı nereden alırım?
Panele giriş yapın ve Hesap → API & anahtarlar bölümünü açın. Yeniden oluşturma işlemi yeni bir anahtar ve gizli anahtar üretir; gizli anahtar yalnızca bir kez gösterilir ve eski çift hemen çalışmayı durdurur.
Kimlik doğrulamayı nasıl yaparım?
Her istekle birlikte Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET gönderin. Gizli anahtarı sunucunuzda tutun; asla bir tarayıcıda veya mobil uygulamada bulundurmayın.
Bir isteğin maliyeti nedir?
Hesabınızı, bakiyenizi ve fiyatları okumak ücretsizdir. POST /v1/sms ve POST /v1/calls panelle aynı fiyatları uygular; bu fiyatlar Kapsama & Fiyatlar sayfasında ve GET /v1/prices yanıtında gösterilir.
Bir SMS en fazla ne kadar uzun olabilir?
İstek başına en fazla 160 karakter. GSM-7 metinde tek segment 160 karakter alır; emojiler veya Latin dışı harfler Unicode'a geçer, bu durumda segment başına 70 karakter sığar ve her segment ayrı ücretlendirilir.
Bir yapay zekâ asistanı API'yi kullanabilir mi?
Evet. Spoofcallerid MCP sunucusunu indirin ve anahtarınızı tanımlayın; Claude veya herhangi bir MCP istemcisi bakiyenizi ve fiyatları kontrol edebilir, SMS gönderebilir ve arama yapabilir. Harcama yapan araçlar önce onay ister.