Developers

Enterprise Risk API

Payout, onboarding या callback से पहले किसी phone number का spam risk और business verification जाँचें — एक signed request, milliseconds में जवाब।

Signed & scoped

HMAC-signed requests, एक बार इस्तेमाल होने वाले nonces, IP allowlists और हर client के अलग scopes।

एक बार में एक नंबर

फ़ैसलों के लिए — data mining के लिए नहीं। न batch input, न directory export।

Privacy by design

सिर्फ़ verified business के नाम दिए जाते हैं। आप जो नंबर जाँचते हैं, हम उन्हें सेव नहीं करते।

Request

import hashlib, hmac, json, secrets, time, requests

path = "/enterprise/v1/risk-check"
body = json.dumps({"number": "+918041234567"})
ts, nonce = str(int(time.time())), secrets.token_hex(16)
canonical = "\n".join([ts, nonce, "POST", path,
                        hashlib.sha256(body.encode()).hexdigest()])
sig = hmac.new(SECRET.encode(), canonical.encode(),
               hashlib.sha256).hexdigest()

r = requests.post("https://api.synsafecaller.com" + path, data=body,
    headers={"Content-Type": "application/json", "X-SSC-Key": KEY_ID,
             "X-SSC-Timestamp": ts, "X-SSC-Nonce": nonce,
             "X-SSC-Signature": sig})

200 OKResponse~40 ms

{
  "request_id": "5b1f0c2e-8c4d-4a6e-9d51-2f7c3a9e1b20",
  "number": "+918041234567",
  "verification": {
    "status": "verified_business",
    "business_name": "Acme Bank",
    "purpose": "support"
  },
  "risk": { "level": "low", "confidence": "high", "category": null },
  "ttl_seconds": 3600,
  "v": 1
}

आपको क्या मिलता है

verification.status: verified_business, claimed या unverified
verification.business_name: सिर्फ़ verified businesses के लिए — किसी व्यक्ति का नाम कभी नहीं
risk.level: unknown, low, medium, elevated या high — community reports और burst detection से
risk.category: सबसे ज़्यादा report हुई श्रेणी, जैसे loan_fraud या telemarketing

Limits और सुरक्षा

हर client के लिए default 10 requests / second
Contract के अनुसार मासिक quota
±5 मिनट की timestamp window, nonces दोबारा नहीं
Emergency नंबर (112, 100, 108…) कभी score नहीं होते

किसके लिए

बैंक और NBFC — account विवरण बताने से पहले caller verify करें
Fintech और payments — payout और refund नंबरों का risk check
Collections और support teams — callback नंबर असली है या नहीं, पुष्टि करें

API access पाएं

Access उद्देश्य-सीमा के साथ contract से ही मिलता है। अपना use case और अनुमानित volume बताएं।

हमसे बात करें — contact@synsafecaller.com

Python, Node.js और PHP examples वाली integration guide approved clients को दी जाती है।