API Documentation

REST, JSON রেসপন্স। সব রিকোয়েস্ট আপনার API key দিয়ে authenticate হয়।

Endpoint

GET https://api.totthohub.com/?api=verify&key=YOUR_KEY&type=nagad&phone=01712345678

প্যারামিটার	মান	বর্ণনা
key	আবশ্যক	আপনার API key (অথবা `X-Api-Key` header)
type	আবশ্যক	`nagad` `bio` `nagad2` `bio2`
phone	phone টাইপে	১১ ডিজিট মোবাইল নাম্বার
id	nid টাইপে	NID নাম্বার

অন্য এন্ডপয়েন্ট

?api=balance	ব্যালেন্স ও কল কাউন্ট
?api=services	লাইভ রেট লিস্ট
?api=history	শেষ ৫০টি সার্চ

HTTP কোড

200	সফল (ডেটা না পেলে body-তে `status:error`)
401	key ভুল বা নেই
402	ব্যালেন্স কম
403	key/একাউন্ট বন্ধ
422	ভুল ইনপুট

স্যাম্পল রেসপন্স

{
  "status": "success",
  "message": "Verification successful",
  "meta": {
    "phone": "01711111112",
    "operator": "GRAMEENPHONE",
    "id": "9103630621",
    "dob": "1993-11-19"
  },
  "bill":   { "txn": "TXN50693FE1", "cost": 220, "cached": false },
  "credit": { "used": 220, "avail": 4780, "total": 5000 }
}

PHP

$url = "https://api.totthohub.com/?api=verify&key=YOUR_KEY&type=nagad&phone=01712345678";
$res = json_decode(file_get_contents($url), true);
if ($res['status'] === 'success') {
    echo $res['meta']['id'];   // NID
} else {
    echo $res['message'];
}

cURL

curl "https://api.totthohub.com/?api=verify&key=YOUR_KEY&type=nagad&phone=01712345678"

ক্যাশ ও বিলিং

একই নাম্বার ২৪ ঘণ্টার মধ্যে আবার চাইলে রেজাল্ট ক্যাশে থেকে সাথে সাথে আসে (bill.cached: true, txn শুরু হয় CX দিয়ে), তবে প্রতি সফল সার্চে আপনার ব্যালেন্স কাটা হয়। ডেটা না পাওয়া গেলে কোনো চার্জ নেই।