রিস্ক লুকআপ এপিআই
বাংলাদেশে মডারেটর-অনুমোদিত প্রতারণার রিপোর্টের সাথে গ্রাহকের তথ্য মিলিয়ে দেখার একটি JSON এপিআই।
দ্রুত শুরু
curl -X POST https://api.fraudfinderbd.com/api/b2b/v1/lookup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"value": "+880 1700-000001"}'অথেন্টিকেশন
আপনার কী Bearer টোকেন হিসেবে পাঠান। কী শুধু সার্ভারে রাখুন।
Authorization: Bearer 12|xxxxxxxxxxxxxxxxxxxxxxxxএন্ডপয়েন্ট
POST /lookup— একটি মান খুঁজুনPOST /lookup/batch— সর্বোচ্চ ৫০টি মান খুঁজুন (প্রতিটি সঠিক মান একবার গণনা হয়)
curl -X POST https://api.fraudfinderbd.com/api/b2b/v1/lookup/batch \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"values": ["01700000001", "fb.com/some.page"]}'রেসপন্স
{
"data": {
"value": "01700000001",
"detected_type": "phone",
"risk": "high",
"matches": [
{
"type": "phone",
"provider": null,
"risk": "high",
"trust_status": "community_verified",
"reports": 5,
"distinct_reporters": 4,
"total_amount_lost": 125000,
"last_reported_at": "2026-10-11T09:30:00+06:00",
"categories": ["f-commerce"],
"profile_url": "https://…/en/p/01J…"
}
]
}
}ঝুঁকির মাত্রা
- high
- একাধিক স্বতন্ত্র, ফোন-যাচাইকৃত ব্যক্তি রিপোর্ট করেছেন (কমিউনিটি যাচাইকৃত)।
- medium
- দুই বা তার বেশি রিপোর্ট, অথবা মালিক আপত্তি জানিয়েছেন এবং যাচাই চলছে।
- low
- একটি অনুমোদিত রিপোর্ট, অথবা বিষয়টির সমাধান হয়েছে।
- none
- কোনো অনুমোদিত রিপোর্ট নেই। এর মানে গ্রাহক নিরাপদ, তা নয়।
গ্রহণযোগ্য মান
যেকোনো ফরম্যাটে ফোন ও ওয়ালেট নম্বর (+880, স্পেস, বাংলা অঙ্ক), ব্যাংক অ্যাকাউন্ট, এনআইডি, ফেসবুক/ইনস্টাগ্রাম/টেলিগ্রাম/হোয়াটসঅ্যাপ লিংক বা হ্যান্ডেল, ওয়েবসাইট ও ইমেইল। নাম গ্রহণ করা হয় না: নাম অনন্য নয়।
স্যান্ডবক্স
স্যান্ডবক্স কী বিনামূল্যে এবং গণনা হয় না। এগুলো নির্দিষ্ট উত্তর দেয়:
| 01700000001 | high |
| 01700000002 | medium |
| 01700000003 | low |
| … | none |
ত্রুটি
{ "error": { "code": "quota_exceeded", "message": "…" } }| 401 | invalid_key |
| 402 | plan_inactive |
| 403 | suspended |
| 422 | invalid_value |
| 429 | rate_limited |
| 429 | quota_exceeded |
সীমা
প্রতিটি প্ল্যানে মিনিটপ্রতি সীমা (Retry-After সহ 429) এবং মাসিক কোটা (429 quota_exceeded) আছে। লাইভ রেসপন্সে X-Quota-Limit ও X-Quota-Remaining হেডার থাকে।
ন্যায্য ব্যবহার
ফলাফল ব্যবহার করে বাড়তি যাচাই যোগ করুন (যেমন ক্যাশ অন ডেলিভারি চাওয়া), কাউকে প্রত্যাখ্যানের একমাত্র কারণ হিসেবে নয়। রিপোর্ট মানুষের অভিজ্ঞতা এবং এতে আপত্তি জানানো যায়।