API v2 রেফারেন্স

ISPbills API v2 রিসোর্স, অপারেশন, ফিল্ড ও স্কোপ

ISPbills ডকুমেন্টেশন টিম আপডেট ১৭ আগস্ট, ২০২৬ ২ মিনিট পড়ুন

সহায়তা নিন

এই নির্দেশিকায় যা আছে

ISPbills API v2 রিসোর্স, অপারেশন, ফিল্ড ও স্কোপ

এই পৃষ্ঠায়

নতুন সার্ভার-টু-সার্ভার ইন্টিগ্রেশনের জন্য API v2 ব্যবহার করুন। বেস পাথ: https://app.ispbills.com/api/v2

টোকেন ও সাধারণ নিয়মের জন্য প্রমাণীকরণ ও মৌলিক বিষয় দেখুন।

প্রমাণীকরণ

মেথড	এন্ডপয়েন্ট	কাজ
`POST`	`/api/v2/auth/token`	Client ID ও Client Secret দিয়ে বিয়ারার টোকেন নেওয়া
`POST`	`/api/v2/auth/revoke`	বর্তমান টোকেন বাতিল করা

গ্রাহক

মেথড	এন্ডপয়েন্ট	স্কোপ ও কাজ
`GET`	`/api/v2/customers`	`customers:read` — পেজিনেটেড তালিকা
`POST`	`/api/v2/customers`	`customers:write` — গ্রাহক তৈরি
`GET`	`/api/v2/customers/{id}`	`customers:read` — গ্রাহকের বিস্তারিত
`PUT`	`/api/v2/customers/{id}`	`customers:write` — গ্রাহক পরিবর্তন
`DELETE`	`/api/v2/customers/{id}`	`customers:write` — গ্রাহক মুছে ফেলা
`GET`	`/api/v2/customers/{id}/bills`	`customers:read` — গ্রাহকের বিল
`GET`	`/api/v2/customers/{id}/payments`	`customers:read` — গ্রাহকের পেমেন্ট
`GET`	`/api/v2/customers/{id}/subscriptions`	`customers:read` — সাবস্ক্রিপশন
`GET`	`/api/v2/customers/{id}/usage`	`customers:read` — ব্যবহার/সেশন

গ্রাহক তৈরিতে username, name, mobile, password, connection_type ও billing_type আবশ্যক। পরিবর্তনের সময় name, mobile ও status পাঠানো যায়।

{
  "username": "fatima-2087",
  "name": "Fatima Begum",
  "mobile": "01898765432",
  "password": "temporary-password",
  "connection_type": "PPPoE",
  "billing_type": "Monthly"
}

বিলিং

মেথড	এন্ডপয়েন্ট	কাজ
`GET`	`/api/v2/billing/bills`	পেজিনেটেড বিল তালিকা
`POST`	`/api/v2/billing/bills`	বিল তৈরি
`GET`	`/api/v2/billing/bills/{id}`	একটি বিল দেখা
`PUT` বা `PATCH`	`/api/v2/billing/bills/{id}`	বিল পরিবর্তন
`DELETE`	`/api/v2/billing/bills/{id}`	বিল মুছে ফেলা
`GET`	`/api/v2/billing/payments`	পেজিনেটেড পেমেন্ট তালিকা

বিল তৈরিতে customer_id, amount ও due_date আবশ্যক। currency ও package_name ঐচ্ছিক। পরিবর্তনের সময় amount, currency, due_date ও is_paid ব্যবহার করা যায়।

প্যাকেজ ও নেটওয়ার্ক

মেথড	এন্ডপয়েন্ট	কাজ
`GET`	`/api/v2/packages`	পেজিনেটেড প্যাকেজ তালিকা
`GET`	`/api/v2/network/routers`	রাউটার/NAS তালিকা
`GET`	`/api/v2/network/olts`	OLT তালিকা
`GET`	`/api/v2/network/onus`	পেজিনেটেড ONU তালিকা
`GET`	`/api/v2/network/pools`	IPv4 পুল তালিকা

মনিটরিং

মেথড	এন্ডপয়েন্ট	কাজ
`GET`	`/api/v2/monitoring/zabbix/hosts`	Zabbix হোস্ট
`GET`	`/api/v2/monitoring/zabbix/problems`	সক্রিয় Zabbix সমস্যা
`GET`	`/api/v2/monitoring/devices`	ডিভাইস স্ট্যাটাস
`GET`	`/api/v2/monitoring/status-checks`	অবকাঠামো স্ট্যাটাস চেক

প্রোভাইডার কনফিগার না থাকলে খালি data অ্যারে আসতে পারে।

SMS

মেথড	এন্ডপয়েন্ট	স্কোপ ও কাজ
`GET`	`/api/v2/sms/balance`	গেটওয়ে ও ব্যালেন্স
`POST`	`/api/v2/sms/send`	`sms:send` — একটি SMS পাঠানো
`POST`	`/api/v2/sms/broadcast`	`sms:send` — সর্বোচ্চ ৫০০ নম্বরে SMS

একক SMS-এ phone ও message; ব্রডকাস্টে phones অ্যারে ও message পাঠান। বার্তা সর্বোচ্চ ৬৪০ অক্ষর।

VPN ও ওয়েবহুক

মেথড	এন্ডপয়েন্ট	কাজ
`GET`	`/api/v2/vpn/accounts`	VPN অ্যাকাউন্ট তালিকা
`GET`	`/api/v2/vpn/accounts/{id}/config`	VPN কনফিগ
`GET`	`/api/v2/webhooks`	ওয়েবহুক এন্ডপয়েন্ট তালিকা
`POST`	`/api/v2/webhooks`	এন্ডপয়েন্ট তৈরি ও একবার সিক্রেট দেখানো
`PUT`	`/api/v2/webhooks/{id}`	URL, ইভেন্ট বা সক্রিয় অবস্থা পরিবর্তন
`DELETE`	`/api/v2/webhooks/{id}`	এন্ডপয়েন্ট মুছে ফেলা

ওয়েবহুক তৈরি ও পরিবর্তনে ফিল্ডের নাম events_json। বিস্তারিত ওয়েবহুক গাইডে দেখুন।

এই তালিকাটি বর্তমানে নিবন্ধিত পাবলিক v2 রুটের সঙ্গে মিলিয়ে তৈরি। অভ্যন্তরীণ সেন্সর, পেমেন্ট ইনজেস্ট, Intercom Canvas ও প্রোভাইডার কলব্যাক রুট এখানে নেই।

আরও সাহায্য দরকার?সম্পর্কিত নির্দেশিকা দেখুন অথবা আমাদের সহায়তা দলের সাথে যোগাযোগ করুন।

বিষয়টি দেখুন সহায়তা নিন