সরাসরি কনটেন্টে যান
TalismanLeadsDocs
হোমAPI কী নিন

API রেফারেন্স

বেস অ্যাড্রেস হলো https://api.talismanleads.io/v1। আপলোড ও ডাউনলোড লিংক ছাড়া রিকোয়েস্ট ও রেসপন্স JSON-এ হয়। এটি OpenAPI ফাইল হিসেবেও পাওয়া যায়।

আপনার ব্যালেন্স

GET/account

আপনার ব্যালেন্স ও কার্যকর লিমিট।

API কী-তে যা লাগবে: রিড-অনলি, অথবা অর্ডার দিতে সক্ষম

উদাহরণ রিকোয়েস্ট

curl "https://api.talismanleads.io/v1/account" \
  -H "Authorization: Bearer tl_live_your_key_here"

উদাহরণ রেসপন্স (200)

{
  "balance": "100.00",
  "currency": "USD",
  "key": {
    "id": "11111111-1111-4111-8111-111111111111",
    "scopes": [
      "read",
      "orders"
    ]
  },
  "limits": {
    "reads_per_minute": 60,
    "result_downloads_per_minute": 30,
    "uploads_per_minute": 10,
    "estimates_per_minute": 10,
    "orders_per_minute": 10,
    "open_task_parts": 20
  }
}

চেকারের তালিকা

GET/checkers

এই অ্যাকাউন্ট এখন কী কী অর্ডার করতে পারে, তার দামে। স্থগিত বা ব্লক করা চেকার তালিকায় থাকে না।

API কী-তে যা লাগবে: রিড-অনলি, অথবা অর্ডার দিতে সক্ষম

উদাহরণ রিকোয়েস্ট

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

উদাহরণ রেসপন্স (200)

{
  "checkers": [
    {
      "id": "whatsapp_status_detection",
      "name": "WhatsApp Status Detection",
      "input": "phone",
      "price": {
        "amount": "3.00",
        "per_entries": 10000,
        "currency": "USD"
      },
      "minimum_entries": 0,
      "minimum_billed_entries": 2000,
      "calling_code": null
    }
  ]
}

বড় লিস্ট আপলোড করুন

POST/uploads

ফাইল সরাসরি স্টোরেজে পাঠানোর একটি লিংক। এটি PUT ও দেওয়া হেডারসহ পাঠান। লিংকটি 2 ঘণ্টা থাকে।

API কী-তে যা লাগবে: অর্ডার দিতে সক্ষম

বডি

size_bytesinteger · আবশ্যক
ফাইলের আকার, বাইটে।
file_namestring · ঐচ্ছিক
লিস্টের একটি নাম, শেষে .txt থাকবে।

উদাহরণ রিকোয়েস্ট

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

উদাহরণ রেসপন্স (201)

{
  "upload_id": "upl_2b7d9f10-6c3e-4a1f-8d2b-9e8f7a6b5c4d",
  "upload_url": "https://storage.example.com/upload/sign/list.txt?token=...",
  "method": "PUT",
  "headers": {
    "Content-Type": "text/plain"
  },
  "expires_at": "2026-11-05T11:00:00.000Z"
}

অর্ডারের খরচ কত হবে দেখুন

POST/estimates

এন্ট্রি গোনে, দাম হিসাব করে এবং লিস্টের যেকোনো সমস্যা জানায়। কিছুই চার্জ করে না। রেসপন্সের জন্য 5 মিনিট পর্যন্ত সময় রাখুন।

API কী-তে যা লাগবে: অর্ডার দিতে সক্ষম

বডি

checkerstring · আবশ্যক
GET /checkers থেকে পাওয়া চেকারের id।
entriesstring[] · ঐচ্ছিক
লিস্ট, প্রতি এন্ট্রিতে একটি string, 100,000টি এন্ট্রি ও 4 MB পর্যন্ত। এটি অথবা upload_id পাঠান।
upload_idstring · ঐচ্ছিক
POST /uploads থেকে পাওয়া upload_id। এটি অথবা entries পাঠান।
countrystring · ঐচ্ছিক
দুই অক্ষরের দেশের কোড, যদি আপনি জানাতে চান নম্বরগুলো কোন দেশের।
file_namestring · ঐচ্ছিক
লিস্টের একটি নাম, শেষে .txt থাকবে।

উদাহরণ রিকোয়েস্ট

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

উদাহরণ রেসপন্স (200)

{
  "checker": "whatsapp_status_detection",
  "entries": 2,
  "billed_entries": 2000,
  "charge": "0.60",
  "currency": "USD",
  "parts": 1,
  "country": {
    "code": "US",
    "share": 1
  }
}

অর্ডার দিন

POST/orders

আপনার ব্যালেন্স থেকে চার্জ করে এবং কাজটি কিউতে রাখে। নতুন অর্ডারে 201 দেয়, আর আবার পাঠালে Idempotent-Replay: true সহ 200; একই মুহূর্তে আবার পাঠালে 201-ও আসতে পারে, তাই id দিয়ে অর্ডার আলাদা করুন। রেসপন্সের জন্য 5 মিনিট পর্যন্ত সময় রাখুন।

API কী-তে যা লাগবে: অর্ডার দিতে সক্ষম

হেডার

Idempotency-Keystring · আবশ্যক
স্পেস ছাড়া 200টি পর্যন্ত ASCII অক্ষর। 7 দিন পর্যন্ত একই Idempotency-Key মানে একই অর্ডার।

বডি

checkerstring · আবশ্যক
GET /checkers থেকে পাওয়া চেকারের id।
entriesstring[] · ঐচ্ছিক
লিস্ট, প্রতি এন্ট্রিতে একটি string, 100,000টি এন্ট্রি ও 4 MB পর্যন্ত। এটি অথবা upload_id পাঠান।
upload_idstring · ঐচ্ছিক
POST /uploads থেকে পাওয়া upload_id। এটি অথবা entries পাঠান।
countrystring · ঐচ্ছিক
দুই অক্ষরের দেশের কোড, যদি আপনি জানাতে চান নম্বরগুলো কোন দেশের।
file_namestring · ঐচ্ছিক
লিস্টের একটি নাম, শেষে .txt থাকবে।
expected_chargestring · ঐচ্ছিক
ডলারে একটি দাম, যেমন "18.00"। খরচ অন্য কিছু হলে অর্ডারটি price_changed সহ প্রত্যাখ্যাত হয়।

উদাহরণ রিকোয়েস্ট

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

উদাহরণ রেসপন্স (201)

{
  "id": "ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f",
  "checker": "whatsapp_status_detection",
  "status": "queued",
  "entries": 2,
  "charge": "0.60",
  "refunded": "0.00",
  "currency": "USD",
  "parts": {
    "total": 1,
    "completed": 0,
    "failed": 0
  },
  "results": null,
  "error": null,
  "source": "api",
  "created_at": "2026-11-05T09:00:00.000Z",
  "completed_at": null
}

আপনার অর্ডারের তালিকা

GET/orders

নতুনগুলো আগে। পরের পেজের জন্য next_cursor cursor হিসেবে ফেরত পাঠান।

API কী-তে যা লাগবে: রিড-অনলি, অথবা অর্ডার দিতে সক্ষম

কোয়েরি প্যারামিটার

limitinteger · ঐচ্ছিক
কতগুলো ফেরত দেবে, 1 থেকে 100। ডিফল্ট 20।
cursorstring · ঐচ্ছিক
শেষ পেজের next_cursor।

উদাহরণ রিকোয়েস্ট

curl "https://api.talismanleads.io/v1/orders?limit=20" \
  -H "Authorization: Bearer tl_live_your_key_here"

উদাহরণ রেসপন্স (200)

{
  "orders": [
    {
      "id": "ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f",
      "checker": "whatsapp_status_detection",
      "status": "completed",
      "entries": 2,
      "charge": "0.60",
      "refunded": "0.00",
      "currency": "USD",
      "parts": {
        "total": 1,
        "completed": 1,
        "failed": 0
      },
      "results": {
        "registered": 1,
        "not_registered": 1
      },
      "error": null,
      "source": "api",
      "created_at": "2026-11-05T09:00:00.000Z",
      "completed_at": "2026-11-05T09:02:10.000Z"
    }
  ],
  "next_cursor": null
}

একটি অর্ডার

GET/orders/{id}

এর স্ট্যাটাস, এন্ট্রি, চার্জ, রিফান্ড, অংশ ও গণনা। কোনো অংশ শেষ না হওয়া পর্যন্ত results হয় null, আর যেখানে চেকার জানায় না সেখানে গণনা null হয়।

API কী-তে যা লাগবে: রিড-অনলি, অথবা অর্ডার দিতে সক্ষম

পাথ প্যারামিটার

idstring · আবশ্যক
অর্ডারের id।

উদাহরণ রিকোয়েস্ট

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

উদাহরণ রেসপন্স (200)

{
  "id": "ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f",
  "checker": "whatsapp_status_detection",
  "status": "completed",
  "entries": 2,
  "charge": "0.60",
  "refunded": "0.00",
  "currency": "USD",
  "parts": {
    "total": 1,
    "completed": 1,
    "failed": 0
  },
  "results": {
    "registered": 1,
    "not_registered": 1
  },
  "error": null,
  "source": "api",
  "created_at": "2026-11-05T09:00:00.000Z",
  "completed_at": "2026-11-05T09:02:10.000Z"
}

ফলাফলের ফাইল

GET/orders/{id}/results

প্রতিটি অংশের জন্য একটি ডাউনলোড লিংক, 15 মিনিট কার্যকর। এখনও চলমান অংশের কোনো লিংক থাকে না। সম্পন্ন অংশের লিংক না থাকলে সাপোর্টে যোগাযোগ করুন।

API কী-তে যা লাগবে: রিড-অনলি, অথবা অর্ডার দিতে সক্ষম

পাথ প্যারামিটার

idstring · আবশ্যক
অর্ডারের id।

উদাহরণ রিকোয়েস্ট

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

উদাহরণ রেসপন্স (200)

{
  "order_id": "ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f",
  "status": "completed",
  "parts": [
    {
      "part": 1,
      "status": "completed",
      "file_name": "result.csv",
      "url": "https://storage.example.com/sign/result.csv?token=...",
      "expires_at": "2026-11-05T09:17:10.000Z"
    }
  ]
}

এরর

আগের

চেকার

পরের

এই পেজে

আপনার ব্যালেন্সচেকারের তালিকাবড় লিস্ট আপলোড করুনঅর্ডারের খরচ কত হবে দেখুনঅর্ডার দিনআপনার অর্ডারের তালিকাএকটি অর্ডারফলাফলের ফাইল