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
BearerHer 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),smsveyavoice.
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ı.toalanı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 dato_countryile birlikte yerel biçimde.caller_id: Zorunlu. Aradığınız kişinin göreceği numara.to_country: İsteğe bağlı.tonumarasının ISO ülke kodu, ör.GB.caller_country: İsteğe bağlı.caller_idnumarasının ISO ülke kodu.record: İsteğe bağlı. Aramayı kaydetmek içintrue. 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 / 5xxHer 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_request400 — Gövde geçerli bir JSON değil veya bir alanın türü yanlış.unauthorized401 — Authorization başlığı eksik veya hatalı biçimlendirilmiş ya da anahtar/gizli anahtar yanlış.insufficient_balance402 — Bakiyeniz maliyeti karşılamıyor. Maliyet ve bakiyeerror.detailsalanında yer alır.not_found404 — Böyle bir uç nokta yok. Yolu ve/v1önekini kontrol edin.method_not_allowed405 — Yanlış HTTP yöntemi; doğru yöntemiAllowbaşlığı gösterir.validation_failed422 — Bir alan eksik veya geçersiz; hangisi olduğunuerror.messagebelirtir.internal_error500 — Bizim tarafımızda bir hata oluştu. Yeniden deneyin, sorun sürerse destekle iletişime geçin.provider_rejected502 — Operatör mesajı veya aramayı reddetti; ücret alınmadı.service_unavailable503 — 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 toolsSpoofcallerid 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?
Kimlik doğrulamayı nasıl yaparım?
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?
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.