মূল বিষয়বস্তুতে যান

ডেভেলপার

API ডকুমেন্টেশন

RESTful API দিয়ে আপনার ই-কমার্স প্ল্যাটফর্মে ফ্রড ডিটেকশন ইন্টিগ্রেট করুন। গড় রেসপন্স টাইম ৩০ms এর কম।

শুরু করুন

  1. অ্যাকাউন্ট তৈরি করুন এবং ড্যাশবোর্ড থেকে API key নিন।
  2. সব রিকোয়েস্টে Authorization: Bearer sk_live_xxxxx হেডার যোগ করুন।
  3. Base URL: https://api.safeguard.bd

অথেনটিকেশন

Bearer token দিয়ে সব API রিকোয়েস্ট অথেনটিকেট করুন।

curl -X POST https://api.safeguard.bd/api/v1/lookup \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"phone": "8801711000000"}'

এন্ডপয়েন্ট

POST
/api/v1/lookup

ফোন নম্বরের রিস্ক স্কোর ও বিস্তারিত রিপোর্ট

POST
/api/v1/lookup/free

অ্যাকাউন্ট ছাড়াই বিনামূল্যে ট্রায়াল লুকআপ

GET
/api/v1/plans

উপলব্ধ সাবস্ক্রিপশন প্ল্যানের তালিকা

GET
/api/v1/usage

বর্তমান মাসের API ব্যবহার ও কোটা স্ট্যাটাস

GET
/api/v1/history

পূর্ববর্তী লুকআপের ইতিহাস (পেজিনেশন সহ)

রেসপন্স ফরম্যাট

সফল রেসপন্স JSON ফরম্যাটে রিটার্ন হয়। HTTP 200 = সফল, 4xx = ক্লায়েন্ট এরর, 5xx = সার্ভার এরর।

{
  "phone": "8801711000000",
  "score": 87,
  "risk_level": "HIGH",
  "delivery_rate": 0.23,
  "fake_order_count": 5,
  "last_seen": "2026-04-29T14:22:00Z",
  "courier_history": [
    { "name": "Pathao", "delivered": 1, "returned": 4 }
  ],
  "recommendation": "BLOCK"
}

LOW

স্কোর < ৪০ — নিরাপদ

MEDIUM

স্কোর ৪০–৭০ — সতর্ক

HIGH

স্কোর > ৭০ — ব্লক করুন

SDK

🟢Node.js
npm install safeguard-bd
🐘PHP
composer require safeguard-bd/sdk
🐍Python
pip install safeguard-bd

ওয়েবহুক

হাই-রিস্ক অর্ডার সনাক্ত হলে আপনার এন্ডপয়েন্টে রিয়েল-টাইম POST রিকোয়েস্ট পাঠানো হবে। ড্যাশবোর্ড > Settings > Webhooks থেকে কনফিগার করুন।

// Webhook payload example
{
  "event": "risk.high_detected",
  "phone": "8801711000000",
  "score": 87,
  "timestamp": "2026-05-02T10:30:00Z"
}

রেট লিমিট

আপনার প্ল্যান অনুযায়ী মাসিক লুকআপ কোটা প্রযোজ্য।

স্টার্টার

৫,০০০/মাস

প্রো

২০,০০০/মাস

এন্টারপ্রাইজ

আনলিমিটেড

কোটা শেষ হলে ড্যাশবোর্ড থেকে আপগ্রেড করুন।

আরো সাহায্য দরকার?

টেকনিক্যাল সমস্যা বা কাস্টম ইন্টিগ্রেশনের জন্য আমাদের ডেভেলপার টিমের সাথে যোগাযোগ করুন।

সাপোর্টে যোগাযোগ করুন →