১. API endpoint
এই API-তে POST request পাঠান। আপনার domain অনুযায়ী সম্পূর্ণ URL:
Production-এ অবশ্যই HTTPS ব্যবহার করুন। Username/password request body-তে পাঠাতে হবে; URL বা query string-এ দেবেন না। Server credentials শুধু iTalk login ও balance retrieval-এর জন্য ব্যবহার করে, response বা application log-এ ফেরত দেয় না।
২. Request format
Header: Content-Type: application/json
{
"username": "আপনার-iTalk-username",
"password": "আপনার-iTalk-password"
}
দুটি field-ই string হতে হবে। Body সর্বোচ্চ 8 KB; প্রতি source IP থেকে মিনিটে সর্বোচ্চ ২০টি request গ্রহণ করা হয়।
৩. cURL উদাহরণ
৪. JavaScript / fetch উদাহরণ
৫. Kotlin client উদাহরণ
Callback background thread-এ চলবে। Interface update করার আগে আপনার platform-এর UI dispatcher ব্যবহার করুন।
৬. সফল response — HTTP 200
{
"ok": true,
"balance": "123.45",
"currency": "BDT",
"checked_at": "2026-10-10T07:46:29+00:00"
}
balance string, currency মুদ্রার code, আর checked_at ISO 8601 timestamp।
৭. Error response ও HTTP status
{"ok": false, "error": "Username and password are required"}
| HTTP status | অর্থ | করণীয় |
| 400 | username/password নেই বা JSON ভুল | Request body ও field-এর নাম যাচাই করুন |
| 405 | POST ছাড়া অন্য method পাঠানো হয়েছে | POST method ব্যবহার করুন |
| 413 | Request body 8 KB-এর বেশি | শুধু username ও password পাঠান |
| 426 | HTTPS আবশ্যক | HTTPS endpoint ব্যবহার করুন |
| 429 | মিনিটে ২০ request limit অতিক্রম করেছে | Retry-After header মেনে অপেক্ষা করুন |
| 502 | iTalk login বা balance retrieval ব্যর্থ | Credentials/account status যাচাই করে পরে চেষ্টা করুন |
| 503 | Server সাময়িকভাবে request সামলাতে পারেনি | কিছুক্ষণ পর আবার চেষ্টা করুন |
৮. নিরাপত্তা
- শুধু নিজের বা account holder-এর অনুমতি থাকা credentials ব্যবহার করুন।
- কাউকে API/page link শেয়ার করতে পারেন; iTalk password কখনো শেয়ার করবেন না।
- যেকোনো client-এ response data দেখাতে পারেন, কিন্তু password log বা analytics-এ পাঠাবেন না।
- প্রতিটি API call iTalk-এ login করে; অপ্রয়োজনীয়ভাবে বারবার polling করবেন না।