Developers

Enterprise Risk API

Payout, onboarding അല്ലെങ്കിൽ callback ന് മുമ്പ് ഒരു ഫോൺ നമ്പറിന്റെ spam അപകടവും 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 ബിസിനസ് പേരുകൾ മാത്രം നൽകുന്നു. നിങ്ങൾ പരിശോധിക്കുന്ന നമ്പറുകൾ ഞങ്ങൾ സൂക്ഷിക്കില്ല.

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 ബിസിനസുകൾക്ക് മാത്രം — ഒരു വ്യക്തിയുടെ പേര് ഒരിക്കലുമില്ല
risk.level: unknown, low, medium, elevated അല്ലെങ്കിൽ high — community reports, burst detection അടിസ്ഥാനമാക്കി
risk.category: ഏറ്റവും കൂടുതൽ report ചെയ്ത വിഭാഗം, ഉദാ. loan_fraud അല്ലെങ്കിൽ telemarketing

Limits & സുരക്ഷ

ഓരോ client നും default ആയി സെക്കൻഡിൽ 10 requests
Contract പ്രകാരം മാസ quota
±5 മിനിറ്റ് timestamp window, nonces വീണ്ടും ഉപയോഗിക്കാനാകില്ല
എമർജൻസി നമ്പറുകൾ (112, 100, 108…) ഒരിക്കലും score ചെയ്യില്ല

ആർക്കുവേണ്ടി

ബാങ്കുകൾ, NBFC കൾ — അക്കൗണ്ട് വിവരങ്ങൾ പങ്കിടും മുമ്പ് കോളറെ verify ചെയ്യൂ
Fintech & payments — payout, refund നമ്പറുകളുടെ അപകട പരിശോധന
Collections & support teams — callback നമ്പർ യഥാർത്ഥമാണോ എന്ന് ഉറപ്പാക്കൂ

API access നേടൂ

ഉദ്ദേശ്യ പരിധിയോടെ contract വഴി മാത്രം access. നിങ്ങളുടെ use case ഉം പ്രതീക്ഷിക്കുന്ന volume ഉം അറിയിക്കൂ.

ഞങ്ങളോട് സംസാരിക്കൂ — contact@synsafecaller.com

Python, Node.js, PHP ഉദാഹരണങ്ങളുള്ള integration guide അംഗീകൃത clients ന് നൽകും.