API ডকুমেন্টেশন

শুরু করা

HLR লুকআপস API ব্যবহার করা প্রমাণীকরণ ধারণাসমূহ SDK PHP NodeJS Ruby

HLR লুকআপসমূহ

POST /hlr-lookup POST /hlr-lookups

MNP লুকআপসমূহ

POST /mnp-lookup POST /mnp-lookups

NT লুকআপসমূহ

POST /nt-lookup POST /nt-lookups

রাউটিং

GET /route GET /routes GET /routing-map GET /hlr-coverage GET /mnp-coverage GET /mnp-countries GET /mccmncs

মূল্য তালিকা

GET /price GET /price-list GET /balance

সরঞ্জাম

GET /auth-test GET /ping GET /time
লিগ্যাসি API ডকুমেন্টেশন

 

 
 

শুরু করা

বৈশ্বিক মোবাইল নেটওয়ার্ক অবকাঠামো SS7 সিগন্যালিং নেটওয়ার্ক নামে পরিচিত একটি সিস্টেমে পরিচালিত হয়। এই নেটওয়ার্ক ক্যারিয়ারগুলির মধ্যে গ্রাহক ডেটা বিনিময়, কল রাউটিং, SMS ট্রান্সমিশন এবং রিয়েল-টাইম মোবাইল সংযোগ স্ট্যাটাস আপডেট সহজতর করে। প্রতিটি মোবাইল নেটওয়ার্ক একটি হোম লোকেশন রেজিস্টার (HLR) রক্ষণাবেক্ষণ করে - একটি মূল ডেটাবেস যা তার গ্রাহকদের সম্পর্কে প্রয়োজনীয় বিবরণ সংরক্ষণ করে।

HLR লুকআপ প্রযুক্তি ব্যবসায়িক প্রতিষ্ঠানগুলিকে এই রেজিস্টারগুলি অনুসন্ধান করতে এবং যেকোনো মোবাইল ফোন নম্বরের জন্য লাইভ সংযোগ এবং নেটওয়ার্ক বিবরণ পুনরুদ্ধার করতে সক্ষম করে। এর মধ্যে রয়েছে ফোনটি চালু আছে কিনা, এটি বর্তমানে কোন নেটওয়ার্কে নিয়োজিত, এটি পোর্ট করা হয়েছে কিনা, নম্বরটি বৈধ বা নিষ্ক্রিয় কিনা এবং এটি রোমিং করছে কিনা।

HLR লুকআপস API এই ডেটাতে নিরবচ্ছিন্ন, রিয়েল-টাইম অ্যাক্সেস প্রদান করে, যা ব্যবসায়িক প্রতিষ্ঠানগুলিকে মোবাইল নম্বর যাচাই করতে, রাউটিং অপ্টিমাইজ করতে এবং গ্রাহক যোগাযোগ উন্নত করতে সক্ষম করে। এই ডকুমেন্টেশন আপনাকে আপনার সফটওয়্যারে HLR লুকআপস একীভূত করার মাধ্যমে রিয়েল-টাইম মোবাইল ইন্টেলিজেন্সের স্বয়ংক্রিয় পুনরুদ্ধার সক্ষম করার জন্য গাইড করবে।

HLR লুকআপস API ব্যবহার করা

HLR লুকআপ কোয়েরি সম্পাদন দ্রুত, নিরাপদ এবং সহজ। একবার আপনি সাইন আপ করে আপনার API কী পেয়ে গেলে, আপনি প্রমাণীকরণ করতে এবং সাধারণ HTTP POST অনুরোধের মাধ্যমে POST /hlr-lookup এর মাধ্যমে তাৎক্ষণিক লুকআপ শুরু করতে পারেন। বিকল্পভাবে, আপনি ধারণা বিভাগে ব্যাখ্যা করা অনুযায়ী ওয়েবহুকের মাধ্যমে আপনার সার্ভারে ফলাফল পোস্ট করে দ্রুত অ্যাসিনক্রোনাস API অনুরোধ বেছে নিয়ে বড় ডেটা সেট প্রক্রিয়া করতে পারেন।

উদাহরণ অনুরোধ

cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/hlr-lookup' \
          -H "X-Digest-Key: YOUR_API_KEY" \
          -H "X-Digest-Signature: DIGEST_AUTH_SIGNATURE" \
          -H "X-Digest-Timestamp: UNIX_TIMESTAMP" \
          -d "@payload.json"

প্রমাণীকরণ HTTP হেডারের মাধ্যমে সরবরাহ করা হয় এবং payload.json এ (ন্যূনতম) নিম্নলিখিত JSON অবজেক্ট থাকা উচিত:

উদাহরণ পেলোড

application/json 
{
   "msisdn": "+14156226819"
}

সফল সম্পাদনের পরে, আপনি নির্দিষ্ট মোবাইল নম্বরের জন্য রিয়েল-টাইম সংযোগ বিবরণ সম্বলিত একটি প্রতিক্রিয়া পাবেন।

সফল রেসপন্স application/json

200 OK 
{
   "id":"f94ef092cb53",
   "msisdn":"+14156226819",
   "connectivity_status":"CONNECTED",
   "mccmnc":"310260",
   "mcc":"310",
   "mnc":"260",
   "imsi":"***************",
   "msin":"**********",
   "msc":"************",
   "original_network_name":"Verizon Wireless",
   "original_country_name":"United States",
   "original_country_code":"US",
   "original_country_prefix":"+1",
   "is_ported":true,
   "ported_network_name":"T-Mobile US",
   "ported_country_name":"United States",
   "ported_country_code":"US",
   "ported_country_prefix":"+1",
   "is_roaming":false,
   "roaming_network_name":null,
   "roaming_country_name":null,
   "roaming_country_code":null,
   "roaming_country_prefix":null,
   "cost":"0.0100",
   "timestamp":"2020-08-07 19:16:17.676+0300",
   "storage":"SYNC-API-2020-08",
   "route":"IP1",
   "processing_status":"COMPLETED",
   "error_code":null,
   "error_description":null,
   "data_source":"LIVE_HLR",
   "routing_instruction":"STATIC:IP1"
}

অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্য এবং সংযোগ স্ট্যাটাসের সম্পূর্ণ বিবরণের জন্য, POST /hlr-lookup দেখুন।

অতিরিক্ত লুকআপ সেবা

মোবাইল নম্বর পোর্টেবিলিটি (MNP) লুকআপ

রিয়েল-টাইম সংযোগ অনুসন্ধান না করে নেটওয়ার্ক মালিকানা এবং পোর্টেবিলিটি বিবরণ নির্ধারণ করতে MNP লুকআপ ব্যবহার করুন। যদি আপনার শুধুমাত্র একটি নম্বরের MCCMNC প্রয়োজন হয়, তাহলে POST /mnp-lookup দেখুন।

নম্বর টাইপ সনাক্তকরণ (NT) লুকআপ

POST /nt-lookup এর মাধ্যমে একটি ফোন নম্বর ল্যান্ডলাইন, মোবাইল, প্রিমিয়াম-রেট, VoIP, পেজার বা অন্যান্য নম্বরিং প্ল্যান রেঞ্জের অন্তর্গত কিনা তা নির্ধারণ করুন।

সফটওয়্যার ডেভেলপমেন্ট কিট (SDK)

HLR লুকআপস API যেকোনো প্রোগ্রামিং ভাষায় যেকোনো REST ক্লায়েন্টের সাথে কাজ করে এবং আমরা আপনাকে দ্রুত শুরু করতে সাহায্য করার জন্য আমাদের GitHub এ PHP, Ruby এবং NodeJS এর জন্য SDK প্রকাশ করেছি।

সরঞ্জাম

একটি নিরবচ্ছিন্ন ডেভেলপমেন্ট অভিজ্ঞতা নিশ্চিত করতে, আমরা একটি ব্যাপক সরঞ্জাম স্যুট অফার করি, যার মধ্যে রয়েছে ইন-ব্রাউজার API অনুরোধ এবং ওয়েবহুক মনিটরিং, IP ঠিকানা হোয়াইটলিস্টিং, শক্তিশালী প্রমাণীকরণ বিকল্প এবং একটি প্রমাণীকরণ টেস্ট এন্ডপয়েন্ট।

ডেভেলপার নন?

HLR লুকআপ এবং নম্বর পোর্টেবিলিটি কোয়েরি কোনো কোডিং ছাড়াই সম্পাদন করা যেতে পারে। আমাদের এন্টারপ্রাইজ ওয়েব ক্লায়েন্ট এবং ব্রাউজার-ভিত্তিক রিপোর্টিং বৈশিষ্ট্য সম্পর্কে আরও জানুন।

প্রমাণীকরণ

নিরাপত্তা এবং সঠিক অ্যাক্সেস নিয়ন্ত্রণ নিশ্চিত করতে, HLR Lookups API-তে বেশিরভাগ অনুরোধের জন্য প্রমাণীকরণ প্রয়োজন। এন্ডপয়েন্টগুলিকে পাবলিক বা সুরক্ষিত হিসাবে শ্রেণীবদ্ধ করা হয়। একটি সুরক্ষিত এন্ডপয়েন্ট অ্যাক্সেস করার সময়, আপনার অনুরোধটি অবশ্যই Digest-Auth অথবা Basic-Auth পদ্ধতির মাধ্যমে আপনার API কী এবং সিক্রেট ব্যবহার করে প্রমাণীকৃত হতে হবে। Digest-Auth হল আরও নিরাপদ বিকল্প এবং এটি দৃঢ়ভাবে সুপারিশ করা হয়। আপনার প্রমাণীকরণ সেটআপ যাচাই করতে GET /auth-test এন্ডপয়েন্ট ব্যবহার করুন।

API কী এবং API সিক্রেট

API সেটিংস পেজ থেকে আপনার API কী এবং সিক্রেট সংগ্রহ করুন। আপনি আপনার পছন্দের প্রমাণীকরণ পদ্ধতি কনফিগার করতে এবং উন্নত নিরাপত্তার জন্য IP অ্যাড্রেস হোয়াইটলিস্টিং সক্রিয় করতে পারেন। যদি আপনার সন্দেহ হয় যে আপনার API সিক্রেট ঝুঁকিতে পড়েছে, তাহলে আপনি যেকোনো সময় একটি নতুন তৈরি করতে পারেন।

API কী পান
বেসিক অথ ডাইজেস্ট অথ IP হোয়াইটলিস্টিং

স্ট্যান্ডার্ড বেসিক প্রমাণীকরণ বাস্তবায়ন করা সহজ এবং ব্যাপকভাবে সমর্থিত। আপনি HTTP অনুরোধে user:pass জোড়া হিসাবে আপনার API কী এবং সিক্রেট পাস করে প্রমাণীকরণ করতে পারেন।

HTTP বেসিক অথ

cURL 
curl 'https://YOUR_API_KEY:YOUR_API_SECRET@www.hlr-lookups.com/api/v2/auth-test'

এটি একটি Authorization হেডার পাঠায়: 

Authorization: Basic BASE64(YOUR_API_KEY:YOUR_API_SECRET)

সুপারিশকৃত: SHA256 সহ X-Basic হেডার

উন্নত নিরাপত্তার জন্য, আপনি সরাসরি base64 হিসাবে প্রেরণ না করে আপনার ক্রেডেনশিয়ালের একটি SHA256 হ্যাশ পাঠাতে পারেন। এই পদ্ধতি ব্যবহার করতে, আপনার YOUR_API_KEY:YOUR_API_SECRET জোড়ার হ্যাশ গণনা করুন এবং X-Basic হেডারের মাধ্যমে পাঠান:

বেসিক অথ অনুরোধ

cURL 
curl 'https://www.hlr-lookups.com/api/v2/auth-test' \
  -H "X-Basic: BASIC_AUTH_HASH"

বেসিক প্রমাণীকরণ হেডার

কী টাইপ বিবরণ
X-Basic string YOUR_API_KEY:YOUR_API_SECRET-এর SHA256 হ্যাশ। হ্যাশে কোলন চিহ্ন (:) অন্তর্ভুক্ত করুন। বাধ্যতামূলক

PHP কোড উদাহরণ

PHP 
$key = 'YOUR_API_KEY';
$secret = 'YOUR_API_SECRET';

$basicAuthHash = hash('sha256', $key . ':' . $secret);

Digest-Auth হল সুরক্ষিত HLR Lookup API এন্ডপয়েন্টগুলিতে অ্যাক্সেস সুরক্ষিত করার জন্য সুপারিশকৃত পদ্ধতি। প্রতিটি অনুরোধে নিম্নলিখিত হেডারগুলি অন্তর্ভুক্ত করতে হবে: X-Digest-Key, X-Digest-Signature, এবং X-Digest-Timestamp, যা নিচে ব্যাখ্যা করা হয়েছে।

অনুরোধের উদাহরণ

cURL 
curl 'https://www.hlr-lookups.com/api/v2/auth-test' \
  -H "X-Digest-Key: YOUR_API_KEY" \
  -H "X-Digest-Signature: DIGEST_AUTH_SIGNATURE" \
  -H "X-Digest-Timestamp: UNIX_TIMESTAMP"

অনুরোধ হেডার

কী টাইপ বিবরণ
X-Digest-Key string আপনার অনন্য HLR Lookups API কী। বাধ্যতামূলক
X-Digest-Signature string একটি অনন্য প্রমাণীকরণ স্বাক্ষর (নিচে দেখুন)। বাধ্যতামূলক
X-Digest-Timestamp integer বর্তমান Unix টাইমস্ট্যাম্প (GET /timeও দেখুন)। বাধ্যতামূলক

স্বাক্ষর তৈরি করা

X-Digest-Signature একটি SHA256 HMAC হ্যাশ ব্যবহার করে তৈরি করা হয়, যেখানে আপনার API সিক্রেট শেয়ার্ড কী হিসাবে ব্যবহৃত হয়।

হ্যাশ করার জন্য স্ট্রিংটি নিম্নরূপ গঠিত:

ENDPOINT_PATH . UNIX_TIMESTAMP . REQUEST_METHOD . REQUEST_BODY

. চিহ্নটি স্ট্রিং সংযোজন নির্দেশ করে।

ডাইজেস্ট স্বাক্ষর উপাদান

উপাদান টাইপ বিবরণ
ENDPOINT_PATH string অনুরোধকৃত API এন্ডপয়েন্ট, যেমন, /auth-test ছোট হাতের অক্ষরে।
UNIX_TIMESTAMP integer বর্তমান Unix টাইমস্ট্যাম্প (৩০ সেকেন্ডের মধ্যে হতে হবে)। GET /time দেখুন।
REQUEST_METHOD string ব্যবহৃত HTTP মেথড, যেমন, POST বা GET।
REQUEST_BODY string অনুরোধ বডি ডেটা। GET অনুরোধের জন্য null সেট করুন।

কোড উদাহরণসমূহ

PHP PHP NodeJS NodeJS Ruby Ruby
PHP 
$path = '/auth-test'
    $timestamp = time();
    $method = 'GET';
    $body = $method == 'GET' ? null : json_encode($params);
    $secret = 'YOUR_API_SECRET';

    $signature = hash_hmac('sha256', $path . $timestamp . $method . $body, $secret);
NodeJS 
require('crypto');

    let path = '/auth-test'
    let timestamp = Date.now() / 1000 | 0;
    let method = 'GET'
    let body = method === 'GET' ? '' : JSON.stringify(params)
    let secret = 'YOUR_API_SECRET'

    let signature = crypto.createHmac('sha256', secret)
                    .update(path + timestamp + method + body)
                    .digest('hex');
Ruby 
require 'openssl'

path = '/auth-test'
timestamp = Time.now.to_i
method = 'GET'
body = method == 'GET' ? NIL : params.to_json
secret = 'YOUR_API_SECRET'

signature = OpenSSL::HMAC.hexdigest('sha256', secret, path + timestamp.to_s + method + body.to_s)

উন্নত নিরাপত্তার জন্য নির্দিষ্ট IP অ্যাড্রেসে অ্যাক্সেস সীমাবদ্ধ করতে API সেটিংস ব্যবহার করুন। এটি বিশেষভাবে প্রোডাকশন পরিবেশে সুপারিশ করা হয়।

উপরে স্ক্রল করুন

ধারণাসমূহ

আমাদের HTTP REST API-এর মাধ্যমে যেকোনো প্রোগ্রামিং ভাষা বা সিস্টেমে HLR লুকআপ বাস্তবায়ন সহজ এবং কার্যকর। একটি সহজ ইন্টিগ্রেশন প্রক্রিয়ার মাধ্যমে, আপনি ফোন নম্বরের বৈধতা, সংযোগ অবস্থা এবং রাউটিং বিবরণ সম্পর্কে তাৎক্ষণিক তথ্যের জন্য রিয়েল-টাইমে মোবাইল নেটওয়ার্ক কুয়েরি শুরু করতে পারেন।

উপযুক্ত API নির্বাচন আপনার নির্দিষ্ট ব্যবহারের ক্ষেত্রের উপর নির্ভর করে। যদি আপনার VoIP টেলিফোনি, জালিয়াতি সনাক্তকরণ বা SMS রাউটিং-এর মতো অ্যাপ্লিকেশনের জন্য রিয়েল-টাইম লুকআপ ফলাফলের প্রয়োজন হয়, তাহলে সিঙ্ক্রোনাস API সেরা পছন্দ। তবে, যদি আপনার ব্যবহারের ক্ষেত্রে উচ্চ-ভলিউম প্রসেসিং, বাল্ক লুকআপ বা বৃহৎ-স্কেল ডেটা যাচাইকরণ জড়িত থাকে, তাহলে অ্যাসিঙ্ক্রোনাস API ব্যান্ডউইথ দক্ষতা এবং ব্যাচ লুকআপ সক্ষমতা সহ অনুকূলিত কর্মক্ষমতা প্রদান করে।

গতি, নির্ভুলতা এবং খরচ-কার্যকারিতা অনুকূল করতে আমাদের কাস্টম রাউটিং অপশনগুলির একটি ব্যবহার করতে API কনফিগার করুন। আপনি সহজ CSV এবং JSON রিপোর্ট ডাউনলোড, সেইসাথে ওয়েব ইন্টারফেসের মাধ্যমে উন্নত বিশ্লেষণের জন্য স্টোরেজে লুকআপ ফলাফল সংরক্ষণ করতে পারেন।

সিঙ্ক্রোনাস HLR লুকআপ API

POST /hlr-lookup এন্ডপয়েন্ট প্রতি অনুরোধে একটি মোবাইল ফোন নম্বর (MSISDN) প্রসেস করে এবং HTTP রেসপন্স বডিতে তাৎক্ষণিক ফলাফল প্রদান করে। ফলাফলগুলি JSON হিসাবে ফরম্যাট করা হয় এবং মোবাইল নম্বর যাচাইকরণ, কল রাউটিং এবং SMS বার্তা বিতরণ সহ রিয়েল-টাইম অ্যাপ্লিকেশনের জন্য আদর্শ।

একটি সিঙ্ক্রোনাস API কল একটি সরাসরি HTTP অনুরোধ এবং রেসপন্স নিয়ে গঠিত। আপনার সিস্টেম প্রতি অনুরোধে একটি একক MSISDN (মোবাইল নম্বর) জমা দেয় এবং JSON ফরম্যাটে রিয়েল-টাইম HLR লুকআপ ফলাফল সম্বলিত একটি তাৎক্ষণিক রেসপন্স পায়। এই API তাৎক্ষণিক যাচাইকরণ এবং সংযোগ পরীক্ষার প্রয়োজন এমন ব্যবহারের ক্ষেত্রের জন্য অনুকূলিত, যেমন জালিয়াতি সনাক্তকরণ, VoIP কল রাউটিং এবং SMS গেটওয়ে অপটিমাইজেশন।

অ্যাসিনক্রোনাস HLR লুকআপ API

POST /hlr-lookups এন্ডপয়েন্ট বাল্ক এবং উচ্চ-ভলিউম প্রসেসিংয়ের জন্য ডিজাইন করা হয়েছে, যা আপনাকে প্রতি অনুরোধে 1,000 পর্যন্ত MSISDN জমা দিতে দেয়। তাৎক্ষণিক ফলাফল প্রদানের পরিবর্তে, এই API আপনার সার্ভারে ক্রমান্বয়ে ফলাফল পাঠাতে স্বয়ংক্রিয় ওয়েবহুক ব্যবহার করে। লুকআপ ফলাফল HTTP POST কলব্যাকের মাধ্যমে JSON অবজেক্ট হিসাবে প্রদান করা হয়।

অ্যাসিঙ্ক্রোনাস API গতি, দক্ষতা এবং স্কেলেবিলিটির জন্য অনুকূলিত। এটি সিঙ্ক্রোনাস কলের সাথে সম্পর্কিত নেটওয়ার্ক লেটেন্সি সমস্যা দূর করে, যা উচ্চ-থ্রুপুট লুকআপের প্রয়োজন এমন ব্যবসার জন্য আদর্শ। আপনার সিস্টেম প্রতি অনুরোধে 1,000 পর্যন্ত MSISDN জমা দেয়, এবং আমাদের প্ল্যাটফর্ম সেগুলি সমান্তরালভাবে প্রসেস করে, প্রতি কলব্যাকে 1,000 পর্যন্ত ফলাফলের ব্যাচে HTTP ওয়েবহুকের মাধ্যমে আপনার সার্ভারে ফলাফল ফেরত পাঠায়।

SDK (সফটওয়্যার ডেভেলপমেন্ট কিট)

PHP, NodeJS এবং Ruby-এর জন্য আমাদের সফটওয়্যার ডেভেলপমেন্ট কিট (SDK) ইন্টিগ্রেশন প্রক্রিয়াকে সহজ করে, যা আপনাকে HLR Lookups API-এর সাথে দক্ষতার সাথে এবং ন্যূনতম প্রচেষ্টায় সংযোগ স্থাপনের সুযোগ দেয়।

এই SDK গুলি পূর্ব-নির্মিত ফাংশন, অথেন্টিকেশন হ্যান্ডলিং এবং সুসংগঠিত API রিকোয়েস্ট টেমপ্লেট প্রদান করে, যা ডেভেলপমেন্ট সময় হ্রাস করে এবং সর্বোত্তম অনুশীলন নিশ্চিত করে।

GitHub-এ আমাদের সম্পূর্ণ উপলব্ধ SDK তালিকা দেখুন এবং আজই ইন্টিগ্রেশন শুরু করুন।

PHP PHP NodeJS NodeJS Ruby Ruby
PHP লোগো

PHP SDK

PHP-এর জন্য তাৎক্ষণিক API ইন্টিগ্রেশন 
1   include('HLRLookupClient.class.php');
2
3   $client = new HLRLookupClient(
4       'YOUR-API-KEY',
5       'YOUR-API-SECRET',
6       '/var/log/hlr-lookups.log'
7   );
8
9   $params = array('msisdn' => '+14156226819');
10  $response = $client->post('/hlr-lookup', $params);
GitHub-এ দেখুন README.md
NodeJS লোগো

NodeJS SDK

NodeJS-এর জন্য তাৎক্ষণিক API ইন্টিগ্রেশন 
1   require('node-hlr-client');
2
3   let response = await client.post('/hlr-lookup', {msisdn: '+491788735000'});
4
5   if (response.status === 200) {
6      // lookup was successful
7      let data = response.data;
8   }
GitHub-এ দেখুন README.md
Ruby লোগো

Ruby SDK

Ruby-এর জন্য তাৎক্ষণিক API ইন্টিগ্রেশন 
1   require 'ruby_hlr_client/client'
2
3   client = HlrLookupsSDK::Client.new(
4       'YOUR-API-KEY',
5       'YOUR-API-SECRET',
6       '/var/log/hlr-lookups.log'
7   )
8
9   params = { :msisdn => '+14156226819' }
10  response = client.get('/hlr-lookup', params)
GitHub-এ দেখুন README.md
উপরে স্ক্রল করুন

POST/hlr-lookupসুরক্ষিত

একটি সিঙ্ক্রোনাস HLR লুকআপ সম্পাদন করে, যা নেটওয়ার্ক অপারেটরদের কাছ থেকে সরাসরি রিয়েল-টাইম মোবাইল ফোন সংযোগ এবং পোর্টেবিলিটি ডেটা সরবরাহ করে। এই এন্ডপয়েন্টটি লাইভ ট্রাফিক পরিস্থিতির জন্য আদর্শ যেখানে সময়-সংবেদনশীল অ্যাপ্লিকেশনগুলির তাৎক্ষণিক যাচাইকরণ প্রয়োজন যে একটি ফোন নম্বর বর্তমানে পৌঁছানো যায় (সংযুক্ত) নাকি অনুপলব্ধ (বন্ধ)। অতিরিক্তভাবে, এটি সক্রিয় নম্বরগুলিকে অবৈধ, অজানা বা জাল নম্বর থেকে আলাদা করতে সাহায্য করে।

বড় ডেটাসেটের বাল্ক প্রসেসিংয়ের জন্য যেগুলিতে তাৎক্ষণিক ফলাফলের প্রয়োজন নেই, অ্যাসিঙ্ক্রোনাস POST /hlr-lookups ব্যবহার করার কথা বিবেচনা করুন, যা উচ্চ-গতির ব্যাচ প্রসেসিংয়ের জন্য অপ্টিমাইজ করা।

যদি আপনার প্রাথমিক ফোকাস মোবাইল নম্বর পোর্টেবিলিটি ডেটা (MCCMNC) পুনরুদ্ধার করা হয় এবং আপনার লাইভ সংযোগ স্ট্যাটাসের প্রয়োজন না হয়, তাহলে POST /mnp-lookup মোবাইল নম্বর পোর্টেবিলিটি কোয়েরির জন্য একটি সাশ্রয়ী বিকল্প প্রদান করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স স্ট্যাটাস রেফারেন্স
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/hlr-lookup' \
          -d "@payload.json"

পেলোড

application/json 
{
   "msisdn":"+14156226819",
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdn string কোয়েরি করার জন্য মোবাইল ফোন নম্বর (MSISDN), আন্তর্জাতিক ফরম্যাটে প্রদান করা (যেমন, +14156226819 বা 0014156226819)। দেশের কোড অবশ্যই অন্তর্ভুক্ত করতে হবে। null বাধ্যতামূলক
route string(3) একটি ঐচ্ছিক তিন-অক্ষরের আইডেন্টিফায়ার যা এই লুকআপের জন্য রুট নির্দিষ্ট করে। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে বা আমাদের সিস্টেমকে এই লুকআপের জন্য সেরা রুট স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null-এ সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
   "id":"f94ef092cb53",
   "msisdn":"+14156226819",
   "connectivity_status":"CONNECTED",
   "mccmnc":"310260",
   "mcc":"310",
   "mnc":"260",
   "imsi":"***************",
   "msin":"**********",
   "msc":"************",
   "original_network_name":"Verizon Wireless",
   "original_country_name":"United States",
   "original_country_code":"US",
   "original_country_prefix":"+1",
   "is_ported":true,
   "ported_network_name":"T-Mobile US",
   "ported_country_name":"United States",
   "ported_country_code":"US",
   "ported_country_prefix":"+1",
   "is_roaming":false,
   "roaming_network_name":null,
   "roaming_country_name":null,
   "roaming_country_code":null,
   "roaming_country_prefix":null,
   "cost":"0.0100",
   "timestamp":"2020-08-07 19:16:17.676+0300",
   "storage":"SYNC-API-2020-08",
   "route":"IP1",
   "processing_status":"COMPLETED",
   "error_code":null,
   "error_description":null,
   "data_source":"LIVE_HLR",
   "routing_instruction":"STATIC:IP1"
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপ অনুরোধের জন্য নির্ধারিত একটি অনন্য শনাক্তকারী। false
msisdn string যে মোবাইল ফোন নম্বরটি অনুসন্ধান করা হচ্ছে, আন্তর্জাতিক ফরম্যাটে ফরম্যাট করা (যেমন, +14156226819 বা 0014156226819)। false
connectivity_status string নম্বরের সংযোগ স্থিতি সফলভাবে পুনরুদ্ধার করা হয়েছে কিনা তা নির্দেশ করে। সম্ভাব্য মান: CONNECTED , ABSENT , INVALID_MSISDN , বা UNDETERMINED । false
mccmnc string(5|6) একটি পাঁচ বা ছয় সংখ্যার মোবাইল কান্ট্রি কোড (MCC) এবং মোবাইল নেটওয়ার্ক কোড (MNC) যা বর্তমানে ফোন নম্বরের সাথে সংযুক্ত নেটওয়ার্ক চিহ্নিত করে। true
mcc string(3) একটি তিন সংখ্যার মোবাইল কান্ট্রি কোড (MCC) যা ফোন নম্বরটি যে দেশে নিবন্ধিত তা চিহ্নিত করে। true
mnc string(2|3) একটি দুই বা তিন সংখ্যার মোবাইল নেটওয়ার্ক কোড (MNC) যা ফোন নম্বরটি যে নির্দিষ্ট নেটওয়ার্কের অন্তর্গত তা চিহ্নিত করে। true
imsi string ইন্টারন্যাশনাল মোবাইল সাবস্ক্রাইবার আইডেন্টিটি (IMSI), এই নম্বরের সাথে সংযুক্ত SIM কার্ডের জন্য একটি অনন্য শনাক্তকারী। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
msin string(10) মোবাইল অপারেটরের ডাটাবেসের মধ্যে মোবাইল সাবস্ক্রিপশন আইডেন্টিফিকেশন নম্বর (MSIN)। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
msc string(12) মোবাইল স্যুইচিং সেন্টার (MSC) যা বর্তমানে এই গ্রাহকের যোগাযোগ পরিচালনা করছে। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
original_network_name string এই নম্বরের সাথে সংযুক্ত মূল (নেটিভ) নেটওয়ার্ক অপারেটরের নাম। true
original_country_name string যে দেশে মোবাইল ফোন নম্বরটি মূলত নিবন্ধিত হয়েছিল তার সম্পূর্ণ নাম, ইংরেজিতে প্রদান করা হয়েছে। true
original_country_code string(2) দুই অক্ষরের ISO দেশ কোড যা ফোন নম্বরটি প্রথম বরাদ্দ করা হয়েছিল সেই দেশকে প্রতিনিধিত্ব করে। true
original_country_prefix string মোবাইল ফোন নম্বরের মূল দেশের সাথে সম্পর্কিত আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড)। true
is_ported boolean মোবাইল নম্বরটি তার মূল নেটওয়ার্ক থেকে একটি ভিন্ন অপারেটরে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। true
ported_network_name string নেটওয়ার্ক অপারেটরের নাম যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_name string দেশের নাম যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_code string(2) দুই অক্ষরের ISO দেশ কোড যা দেশকে প্রতিনিধিত্ব করে যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_prefix string দেশের জন্য আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড) যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
is_roaming boolean মোবাইল নম্বরটি বর্তমানে একটি বিদেশী নেটওয়ার্কে রোমিং করছে কিনা তা নির্দেশ করে। রোমিং স্থিতির প্রাপ্যতা মোবাইল নেটওয়ার্ক অপারেটরের উপর নির্ভর করে। true
roaming_network_name string নেটওয়ার্কের নাম যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_name string দেশের নাম যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_code string(2) দেশের দুই অক্ষরের ISO দেশ কোড যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_prefix string দেশের আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড) যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
cost string একটি স্ট্রিং হিসাবে উপস্থাপিত একটি দশমিক মান, যা EUR-এ লুকআপ খরচ নির্দেশ করে। true
timestamp string টাইম জোন সহ একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প, যা লুকআপ কখন সম্পন্ন হয়েছিল তা নির্দিষ্ট করে। true
storage string স্টোরেজের নাম যেখানে লুকআপ ফলাফল সংরক্ষণ করা হয়েছিল। এটি ওয়েব ইন্টারফেসের মাধ্যমে উপলব্ধ রিপোর্ট নাম এবং CSV ডাউনলোডের সাথে সম্পর্কিত। true
route string(3) একটি তিন অক্ষরের শনাক্তকারী যা এই লুকআপ অনুরোধের জন্য ব্যবহৃত রাউটিং পদ্ধতি নির্দেশ করে। true
processing_status string লুকআপের প্রসেসিং ফলাফল। সম্ভাব্য মান: COMPLETED (সফল), REJECTED (নেটওয়ার্ক পৌঁছানো যায় না, কোনো চার্জ প্রয়োগ করা হয়নি), বা FAILED (প্রসেসিং এর সময় ত্রুটি ঘটেছে)। false
error_code integer একটি ঐচ্ছিক অভ্যন্তরীণ ত্রুটি কোড যা গ্রাহক সহায়তার জন্য অতিরিক্ত ডায়াগনস্টিক তথ্য প্রদান করে। true
error_description string প্রদত্ত ত্রুটি কোডের (যদি থাকে) একটি সংক্ষিপ্ত ব্যাখ্যা ইংরেজি সাধারণ পাঠ্যে। true
data_source string এই অনুরোধের জন্য ব্যবহৃত ডেটা উৎস। সম্ভাব্য মান: LIVE_HLR (রিয়েল-টাইম HLR কোয়েরি) বা MNP_DB (স্ট্যাটিক মোবাইল নম্বর পোর্টেবিলিটি ডাটাবেস)। বিস্তারিত জানতে রাউটিং অপশন দেখুন। false
routing_instruction string একটি কোলন-বিভাজিত স্ট্রিং যা অনুরোধে ব্যবহৃত রাউটিং নির্দেশনা বর্ণনা করে। প্রথম উপাদানটি STATIC হয় যখন আপনি একটি রুট নির্দিষ্ট করেন অথবা স্বয়ংক্রিয় রাউটিংয়ের জন্য AUTO হয়; দ্বিতীয় উপাদানটি রুট শনাক্তকারী, এবং স্বয়ংক্রিয় রাউটিং অনুরোধের ক্ষেত্রে তৃতীয় উপাদানটি উৎস প্রদর্শন করে যার উপর ভিত্তি করে রাউটিং সিদ্ধান্ত নেওয়া হয় (অর্থাৎ SCORE, CUSTOM_GLOBAL_COUNTRY, CUSTOM_GLOBAL_MCCMNC, CUSTOM_GLOBAL_PREFIX, CUSTOM_USER_COUNTRY, CUSTOM_USER_MCCMNC, CUSTOM_USER_PREFIX, MNP_FALLBACK, PLATFORM_DEFAULT, USER_DEFAULT)। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
স্ট্যাটাস বিবরণ
CONNECTED নম্বরটি বৈধ এবং লক্ষ্য হ্যান্ডসেটটি বর্তমানে মোবাইল নেটওয়ার্কের সাথে সংযুক্ত রয়েছে। কল, এসএমএস এবং অন্যান্য সেবা সফলভাবে প্রাপকের কাছে পৌঁছানো উচিত।
ABSENT নম্বরটি বৈধ, কিন্তু লক্ষ্য হ্যান্ডসেটটি হয় বন্ধ রয়েছে অথবা সাময়িকভাবে নেটওয়ার্ক কভারেজের বাইরে রয়েছে। ডিভাইসটি নেটওয়ার্কের সাথে পুনরায় সংযুক্ত না হওয়া পর্যন্ত বার্তা বা কল সরবরাহ নাও হতে পারে।
INVALID_MSISDN নম্বরটি অবৈধ বা বর্তমানে মোবাইল নেটওয়ার্কে কোনো গ্রাহকের জন্য বরাদ্দ নেই। এই নম্বরে কল এবং বার্তা ব্যর্থ হবে।
UNDETERMINED নম্বরটির সংযোগ স্থিতি নির্ধারণ করা যায়নি। এটি একটি অবৈধ নম্বর, SS7 ত্রুটি প্রতিক্রিয়া, অথবা লক্ষ্য নেটওয়ার্ক অপারেটরের সাথে সংযোগের অভাবের কারণে হতে পারে। অতিরিক্ত নির্ণয়ের জন্য ত্রুটি কোড এবং এর বিবরণ ক্ষেত্র পরীক্ষা করুন।
উপরে স্ক্রল করুন

POST/hlr-lookupsসুরক্ষিত

অ্যাসিনক্রোনাস HLR লুকআপের একটি ব্যাচ শুরু করে, নেটওয়ার্ক অপারেটরদের থেকে লাইভ মোবাইল ফোন সংযোগ এবং পোর্টেবিলিটি ডেটা পুনরুদ্ধার করে। ফলাফলগুলি ওয়েবহুকের মাধ্যমে আপনার সার্ভারে প্রদান করা হয়। এই পদ্ধতিটি বৃহৎ পরিমাণ নম্বর প্রক্রিয়াকরণের জন্য অপ্টিমাইজ করা হয়েছে যেগুলির তাৎক্ষণিক প্রতিক্রিয়ার প্রয়োজন নেই, যেমন ডেটাবেস পরিষ্কার এবং যাচাইকরণ। কল রাউটিং বা SMS ডেলিভারির মতো রিয়েল-টাইম অ্যাপ্লিকেশনের জন্য, পরিবর্তে POST /hlr-lookup এন্ডপয়েন্ট ব্যবহার করার কথা বিবেচনা করুন।

এই এন্ডপয়েন্টটি বাল্ক প্রসেসিংয়ের জন্য আদর্শ যখন লক্ষ্য হল বর্তমানে পৌঁছানো যায় (সংযুক্ত) বা অনুপলব্ধ (ফোন বন্ধ) ফোন নম্বরগুলি চিহ্নিত করা এবং অবৈধ, অনির্ধারিত বা জাল নম্বরগুলি ফিল্টার করা। অতিরিক্তভাবে, এটি সংযোগের বিবরণের পাশাপাশি লাইভ পোর্টেবিলিটি স্ট্যাটাস (MCCMNC) প্রদান করে।

এই এন্ডপয়েন্ট ব্যবহার করার আগে, নিশ্চিত করুন যে লুকআপ ফলাফল অ্যাসিনক্রোনাসভাবে গ্রহণ করার জন্য একটি ওয়েবহুক URL কনফিগার করা আছে। আপনি এটি আপনার API সেটিংস-এ সেট আপ করতে পারেন।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স ওয়েবহুক স্ট্যাটাস রেফারেন্স
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/hlr-lookups' \
          -d "@payload.json"

পেলোড

application/json 
{
   "msisdns":["+14156226819","+491788735000","+905536939460"],
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdns array আন্তর্জাতিক ফরম্যাটে মোবাইল ফোন নম্বরের (MSISDNs) একটি অ্যারে (যেমন +14156226819 বা 0014156226819)। প্রতি অনুরোধে আপনি সর্বোচ্চ 1000টি নম্বর অন্তর্ভুক্ত করতে পারেন। null বাধ্যতামূলক
route string(3) একটি ঐচ্ছিক তিন-অক্ষরের আইডেন্টিফায়ার যা এই লুকআপের জন্য রুট নির্দিষ্ট করে। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে বা আমাদের সিস্টেমকে এই লুকআপের জন্য সেরা রুট স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null-এ সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
   "accepted":[
      {
         "id":"0424928f332e",
         "msisdn":"+491788735000"
      }
   ],
   "accepted_count":1,
   "rejected":[
      {
         "id":null,
         "msisdn":"+31"
      }
   ],
   "rejected_count":1,
   "total_count":2,
   "cost":"0.01",
   "storage":"ASYNC-API-2020-08",
   "route":"IP1",
   "webhook_urls":[
      "https://your-server.com/endpoint"
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
accepted array প্রক্রিয়াকরণের জন্য গৃহীত অনন্য আইডেন্টিফায়ার এবং MSISDNs সমন্বিত অবজেক্টের একটি তালিকা। false
accepted_count integer প্রক্রিয়াকরণের জন্য সফলভাবে গৃহীত MSISDNs-এর মোট সংখ্যা। false
rejected array প্রক্রিয়াকরণের জন্য প্রত্যাখ্যাত অনন্য আইডেন্টিফায়ার এবং MSISDNs সমন্বিত অবজেক্টের একটি তালিকা, সাধারণত অবৈধ নম্বরের কারণে। প্রত্যাখ্যাত এন্ট্রিগুলির জন্য কোনো চার্জ প্রযোজ্য নয়। false
rejected_count integer যাচাইকরণ ত্রুটির কারণে প্রত্যাখ্যাত MSISDNs-এর মোট সংখ্যা। false
total_count integer প্রক্রিয়াকরণের জন্য জমা দেওয়া গৃহীত এবং প্রত্যাখ্যাত MSISDNs-এর মোট সংখ্যা। false
cost string একটি স্ট্রিং হিসাবে উপস্থাপিত দশমিক মান, যা গৃহীত লুকআপগুলির জন্য EUR-এ মোট খরচ নির্দেশ করে। false
storage string স্টোরেজের নাম যেখানে লুকআপ ফলাফল যুক্ত করা হয়, ওয়েব ইন্টারফেসের মাধ্যমে রিপোর্টিং এবং CSV ডাউনলোডের জন্য ব্যবহৃত। false
route string(3|4) একটি তিন বা চার অক্ষরের আইডেন্টিফায়ার যা এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে। নম্বর-ভিত্তিক স্বয়ংক্রিয় রাউটিং অনুরোধ করা হলে AUTO থাকে। false
webhook_urls array আপনার API সেটিংস-এ কনফিগার করা ওয়েবহুক URL। ফলাফলগুলি এখানে পোস্ট করা হয়। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false

ওয়েবহুক প্রক্রিয়াকরণ

জমা দেওয়ার পর, আমাদের প্ল্যাটফর্ম প্রদত্ত ফোন নম্বরগুলি প্রক্রিয়া করা শুরু করে এবং ফলাফল আপনার সার্ভারে পূর্বনির্ধারিত ওয়েবহুক URL-এ পাঠায়। ফলাফলগুলি একটি HTTP POST রিকোয়েস্ট হিসাবে রিকোয়েস্ট বডিতে JSON অবজেক্টসহ প্রেরণ করা হয়।

প্রমাণীকরণ

X-Signatures HTTP হেডার পরীক্ষা করে ওয়েবহুক যাচাই করুন।

X-Signatures হেডারে সেমিকোলন দ্বারা পৃথক করা স্বাক্ষরের একটি তালিকা রয়েছে। তালিকার প্রতিটি স্বাক্ষর আপনার অ্যাকাউন্টে কনফিগার করা API সিক্রেটগুলির একটি ব্যবহার করে তৈরি করা হয়। ওয়েবহুক যাচাই করতে, আপনার API কী, সিক্রেট এবং রও HTTP বডি ব্যবহার করে একটি SHA-256 হ্যাশ তৈরি করুন - তারপর এটি তালিকার স্বাক্ষরগুলির সাথে তুলনা করুন।

একটি মিল নিশ্চিত করে যে রিকোয়েস্টটি প্রকৃত এবং আপনার নিয়ন্ত্রিত একটি সিক্রেট দিয়ে স্বাক্ষরিত।

PHP কোড উদাহরণ

PHP 
$signaturesHeader = (getallheaders() ?? [])['X-Signatures'] ?? ''; // list of signatures
$key = getenv('AUTH_KEY'); // Your API Key
$secret = getenv('AUTH_SECRET'); // Your API Secret
$payload = file_get_contents('php://input'); // The HTTP body of the incoming POST request

// Generate the expected signature
$expectedSignature = hash('sha256', $key . $secret . $payload);

// Split the header into individual signatures
$providedSignatures = explode(';', $signaturesHeader);

// Check if any signature matches
$valid = false;
foreach ($providedSignatures as $sig) {
    if (hash_equals($expectedSignature, $sig)) {
        $valid = true;
        break;
    }
}

রিকোয়েস্টটি বৈধ যদি হেডারে প্রদত্ত যেকোনো স্বাক্ষর আপনার API কী, সিক্রেট এবং HTTP বডির সংযুক্ত স্ট্রিং থেকে গণনা করা SHA256 হ্যাশের সমান হয়।

প্রাপ্তি নিশ্চিতকরণ

সফল প্রাপ্তি নিশ্চিত করতে আপনার সার্ভার থেকে HTTP স্ট্যাটাস কোড 200 OK দিয়ে প্রতিক্রিয়া প্রত্যাশিত। যদি অন্য কোনো রেসপন্স কোড ফেরত আসে, টাইমআউট ঘটে (১০ সেকেন্ড), বা অন্য কোনো ডেলিভারি সমস্যা দেখা দেয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে এক মিনিট পরে ওয়েবহুক পুনরায় চেষ্টা করবে। রিকোয়েস্ট ব্যর্থ হতে থাকলে, পুনঃপ্রচেষ্টা একটি এক্সপোনেনশিয়াল ব্যাকঅফ কৌশল অনুসরণ করবে, পরবর্তী প্রচেষ্টা 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024 মিনিট পরে হবে।

এই পুনঃপ্রচেষ্টা প্রক্রিয়া আপনার অবকাঠামোতে লুকআপ ফলাফল সরবরাহে সর্বোচ্চ নির্ভরযোগ্যতা নিশ্চিত করে। এটি অস্থায়ী নেটওয়ার্ক সমস্যা বা সার্ভার ডাউনটাইমের কারণে ডেটা হারানোর ঝুঁকি কমায়।

ওয়েবহুক পেলোড

HTTP POST (application/json) 
{
   "type":"HLR",
   "results":[
      {
         "id":"3b4ac4b6ed1b",
         "msisdn":"+905536939460",
         "connectivity_status":"CONNECTED",
         "mccmnc":"28603",
         "mcc":"286",
         "mnc":"03",
         "imsi":"28603XXXXXXXXXX",
         "msin":"XXXXXXXXXX",
         "msc":"XXXXXXXXXX",
         "original_network_name":"Turk Telekom (AVEA)",
         "original_country_name":"Turkey",
         "original_country_code":"TR",
         "original_country_prefix":"+90",
         "is_ported":false,
         "ported_network_name":null,
         "ported_country_name":null,
         "ported_country_code":null,
         "ported_country_prefix":null,
         "is_roaming":false,
         "roaming_network_name":null,
         "roaming_country_name":null,
         "roaming_country_code":null,
         "roaming_country_prefix":null,
         "cost":"0.0100",
         "timestamp":"2020-08-13 00:04:38.261+0300",
         "storage":"ASYNC-API-2020-08",
         "route":"IP1",
         "processing_status":"COMPLETED",
         "error_code":null,
         "error_description":null,
         "data_source":"LIVE_HLR",
         "routing_instruction":"STATIC:IP1"
      }
   ]
}

ওয়েবহুক পেলোড অ্যাট্রিবিউটস

JSON অবজেক্টে একটি type => HLR অ্যাট্রিবিউটের পাশাপাশি একটি results অ্যাট্রিবিউট রয়েছে যাতে লুকআপ অবজেক্টের একটি তালিকা অন্তর্ভুক্ত থাকে, যা নিচে নথিভুক্ত করা হয়েছে।

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপ অনুরোধের জন্য নির্ধারিত একটি অনন্য শনাক্তকারী। false
msisdn string যে মোবাইল ফোন নম্বরটি অনুসন্ধান করা হচ্ছে, আন্তর্জাতিক ফরম্যাটে ফরম্যাট করা (যেমন, +14156226819 বা 0014156226819)। false
connectivity_status string নম্বরের সংযোগ স্থিতি সফলভাবে পুনরুদ্ধার করা হয়েছে কিনা তা নির্দেশ করে। সম্ভাব্য মান: CONNECTED , ABSENT , INVALID_MSISDN , বা UNDETERMINED । false
mccmnc string(5|6) একটি পাঁচ বা ছয় সংখ্যার মোবাইল কান্ট্রি কোড (MCC) এবং মোবাইল নেটওয়ার্ক কোড (MNC) যা বর্তমানে ফোন নম্বরের সাথে সংযুক্ত নেটওয়ার্ক চিহ্নিত করে। true
mcc string(3) একটি তিন সংখ্যার মোবাইল কান্ট্রি কোড (MCC) যা ফোন নম্বরটি যে দেশে নিবন্ধিত তা চিহ্নিত করে। true
mnc string(2|3) একটি দুই বা তিন সংখ্যার মোবাইল নেটওয়ার্ক কোড (MNC) যা ফোন নম্বরটি যে নির্দিষ্ট নেটওয়ার্কের অন্তর্গত তা চিহ্নিত করে। true
imsi string ইন্টারন্যাশনাল মোবাইল সাবস্ক্রাইবার আইডেন্টিটি (IMSI), এই নম্বরের সাথে সংযুক্ত SIM কার্ডের জন্য একটি অনন্য শনাক্তকারী। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
msin string(10) মোবাইল অপারেটরের ডাটাবেসের মধ্যে মোবাইল সাবস্ক্রিপশন আইডেন্টিফিকেশন নম্বর (MSIN)। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
msc string(12) মোবাইল স্যুইচিং সেন্টার (MSC) যা বর্তমানে এই গ্রাহকের যোগাযোগ পরিচালনা করছে। প্রাপ্যতা নেটওয়ার্ক কনফিগারেশনের উপর নির্ভর করে। true
original_network_name string এই নম্বরের সাথে সংযুক্ত মূল (নেটিভ) নেটওয়ার্ক অপারেটরের নাম। true
original_country_name string যে দেশে মোবাইল ফোন নম্বরটি মূলত নিবন্ধিত হয়েছিল তার সম্পূর্ণ নাম, ইংরেজিতে প্রদান করা হয়েছে। true
original_country_code string(2) দুই অক্ষরের ISO দেশ কোড যা ফোন নম্বরটি প্রথম বরাদ্দ করা হয়েছিল সেই দেশকে প্রতিনিধিত্ব করে। true
original_country_prefix string মোবাইল ফোন নম্বরের মূল দেশের সাথে সম্পর্কিত আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড)। true
is_ported boolean মোবাইল নম্বরটি তার মূল নেটওয়ার্ক থেকে একটি ভিন্ন অপারেটরে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। true
ported_network_name string নেটওয়ার্ক অপারেটরের নাম যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_name string দেশের নাম যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_code string(2) দুই অক্ষরের ISO দেশ কোড যা দেশকে প্রতিনিধিত্ব করে যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
ported_country_prefix string দেশের জন্য আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড) যেখানে মোবাইল নম্বরটি পোর্ট করা হয়েছে, যদি প্রযোজ্য হয়। true
is_roaming boolean মোবাইল নম্বরটি বর্তমানে একটি বিদেশী নেটওয়ার্কে রোমিং করছে কিনা তা নির্দেশ করে। রোমিং স্থিতির প্রাপ্যতা মোবাইল নেটওয়ার্ক অপারেটরের উপর নির্ভর করে। true
roaming_network_name string নেটওয়ার্কের নাম যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_name string দেশের নাম যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_code string(2) দেশের দুই অক্ষরের ISO দেশ কোড যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
roaming_country_prefix string দেশের আন্তর্জাতিক ডায়ালিং কোড (দেশ কলিং কোড) যেখানে মোবাইল নম্বরটি বর্তমানে রোমিং করছে, যদি প্রযোজ্য হয়। true
cost string একটি স্ট্রিং হিসাবে উপস্থাপিত একটি দশমিক মান, যা EUR-এ লুকআপ খরচ নির্দেশ করে। true
timestamp string টাইম জোন সহ একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প, যা লুকআপ কখন সম্পন্ন হয়েছিল তা নির্দিষ্ট করে। true
storage string স্টোরেজের নাম যেখানে লুকআপ ফলাফল সংরক্ষণ করা হয়েছিল। এটি ওয়েব ইন্টারফেসের মাধ্যমে উপলব্ধ রিপোর্ট নাম এবং CSV ডাউনলোডের সাথে সম্পর্কিত। true
route string(3) একটি তিন অক্ষরের শনাক্তকারী যা এই লুকআপ অনুরোধের জন্য ব্যবহৃত রাউটিং পদ্ধতি নির্দেশ করে। true
processing_status string লুকআপের প্রসেসিং ফলাফল। সম্ভাব্য মান: COMPLETED (সফল), REJECTED (নেটওয়ার্ক পৌঁছানো যায় না, কোনো চার্জ প্রয়োগ করা হয়নি), বা FAILED (প্রসেসিং এর সময় ত্রুটি ঘটেছে)। false
error_code integer একটি ঐচ্ছিক অভ্যন্তরীণ ত্রুটি কোড যা গ্রাহক সহায়তার জন্য অতিরিক্ত ডায়াগনস্টিক তথ্য প্রদান করে। true
error_description string প্রদত্ত ত্রুটি কোডের (যদি থাকে) একটি সংক্ষিপ্ত ব্যাখ্যা ইংরেজি সাধারণ পাঠ্যে। true
data_source string এই অনুরোধের জন্য ব্যবহৃত ডেটা উৎস। সম্ভাব্য মান: LIVE_HLR (রিয়েল-টাইম HLR কোয়েরি) বা MNP_DB (স্ট্যাটিক মোবাইল নম্বর পোর্টেবিলিটি ডাটাবেস)। বিস্তারিত জানতে রাউটিং অপশন দেখুন। false
routing_instruction string একটি কোলন-বিভাজিত স্ট্রিং যা অনুরোধে ব্যবহৃত রাউটিং নির্দেশনা বর্ণনা করে। প্রথম উপাদানটি STATIC হয় যখন আপনি একটি রুট নির্দিষ্ট করেন অথবা স্বয়ংক্রিয় রাউটিংয়ের জন্য AUTO হয়; দ্বিতীয় উপাদানটি রুট শনাক্তকারী, এবং স্বয়ংক্রিয় রাউটিং অনুরোধের ক্ষেত্রে তৃতীয় উপাদানটি উৎস প্রদর্শন করে যার উপর ভিত্তি করে রাউটিং সিদ্ধান্ত নেওয়া হয় (অর্থাৎ SCORE, CUSTOM_GLOBAL_COUNTRY, CUSTOM_GLOBAL_MCCMNC, CUSTOM_GLOBAL_PREFIX, CUSTOM_USER_COUNTRY, CUSTOM_USER_MCCMNC, CUSTOM_USER_PREFIX, MNP_FALLBACK, PLATFORM_DEFAULT, USER_DEFAULT)। false
স্ট্যাটাস বিবরণ
CONNECTED নম্বরটি বৈধ এবং লক্ষ্য হ্যান্ডসেটটি বর্তমানে মোবাইল নেটওয়ার্কের সাথে সংযুক্ত রয়েছে। কল, এসএমএস এবং অন্যান্য সেবা সফলভাবে প্রাপকের কাছে পৌঁছানো উচিত।
ABSENT নম্বরটি বৈধ, কিন্তু লক্ষ্য হ্যান্ডসেটটি হয় বন্ধ রয়েছে অথবা সাময়িকভাবে নেটওয়ার্ক কভারেজের বাইরে রয়েছে। ডিভাইসটি নেটওয়ার্কের সাথে পুনরায় সংযুক্ত না হওয়া পর্যন্ত বার্তা বা কল সরবরাহ নাও হতে পারে।
INVALID_MSISDN নম্বরটি অবৈধ বা বর্তমানে মোবাইল নেটওয়ার্কে কোনো গ্রাহকের জন্য বরাদ্দ নেই। এই নম্বরে কল এবং বার্তা ব্যর্থ হবে।
UNDETERMINED নম্বরটির সংযোগ স্থিতি নির্ধারণ করা যায়নি। এটি একটি অবৈধ নম্বর, SS7 ত্রুটি প্রতিক্রিয়া, অথবা লক্ষ্য নেটওয়ার্ক অপারেটরের সাথে সংযোগের অভাবের কারণে হতে পারে। অতিরিক্ত নির্ণয়ের জন্য ত্রুটি কোড এবং এর বিবরণ ক্ষেত্র পরীক্ষা করুন।
উপরে স্ক্রল করুন

POST/mnp-lookupসুরক্ষিত

একটি সিঙ্ক্রোনাস MNP লুকআপ সম্পাদন করে এবং মোবাইল নম্বর পোর্টেবিলিটি ও নেটওয়ার্ক তথ্য প্রদান করে। এই এন্ডপয়েন্টটি উপযুক্ত যদি আপনার প্রধান লক্ষ্য হয় একটি নির্দিষ্ট মোবাইল ফোন নম্বরের বর্তমান MCCMNC নিষ্কাশন করা এবং রিয়েল-টাইমে মূল ও বর্তমান নেটওয়ার্ক চিহ্নিত করা।

বড় ডেটাসেটের বাল্ক প্রসেসিংয়ের জন্য যেগুলিতে তাৎক্ষণিক ফলাফলের প্রয়োজন নেই, অ্যাসিঙ্ক্রোনাস POST /mnp-lookups ব্যবহার করার কথা বিবেচনা করুন, যা উচ্চ-গতির ব্যাচ প্রসেসিংয়ের জন্য অপ্টিমাইজ করা।

MNP কোয়েরি নির্ভরযোগ্যভাবে পোর্টেবিলিটি এবং নেটওয়ার্ক তথ্য নির্ধারণ করে কিন্তু লক্ষ্য মোবাইল ফোনটি বর্তমানে কোনো নেটওয়ার্কে সংযুক্ত এবং পৌঁছানোযোগ্য কিনা তা নির্দেশ করে না। লাইভ সংযোগ তথ্য নিষ্কাশন করতে, অনুগ্রহ করে POST /hlr-lookup এন্ডপয়েন্ট ব্যবহার করুন।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/mnp-lookup' \
          -d "@payload.json"

পেলোড

application/json 
{
   "msisdn":"+14156226819",
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdn string কোয়েরি করার জন্য মোবাইল ফোন নম্বর (MSISDN), আন্তর্জাতিক ফরম্যাটে প্রদান করা (যেমন, +14156226819 বা 0014156226819)। দেশের কোড অবশ্যই অন্তর্ভুক্ত করতে হবে। null বাধ্যতামূলক
route string(3) একটি ঐচ্ছিক তিন-অক্ষরের আইডেন্টিফায়ার যা এই লুকআপের জন্য রুট নির্দিষ্ট করে। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে বা আমাদের সিস্টেমকে এই লুকআপের জন্য সেরা রুট স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null-এ সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
   "id":"e428acb1c0ae",
   "msisdn":"+14156226819",
   "query_status":"OK",
   "mccmnc":"310260",
   "mcc":"310",
   "mnc":"260",
   "is_ported":true,
   "original_network_name":"Verizon Wireless:6006 - SVR/2",
   "original_country_name":"United States",
   "original_country_code":"US",
   "original_country_prefix":"+1415",
   "ported_network_name":"T-Mobile US:6529 - SVR/2",
   "ported_country_name":"United States",
   "ported_country_code":"US",
   "ported_country_prefix":"+1",
   "extra":"LRN:4154250000",
   "cost":"0.0050",
   "timestamp":"2020-08-05 21:21:33.490+0300",
   "storage":"WEB-CLIENT-SOLO-MNP-2020-08",
   "route":"PTX",
   "error_code":null
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপের জন্য একটি অনন্য ১২-অক্ষরের শনাক্তকারী। false
msisdn string এই লুকআপ অনুরোধে মূল্যায়ন করা মোবাইল ফোন নম্বর। false
query_status string পোর্টেবিলিটি এবং নেটওয়ার্ক তথ্য পুনরুদ্ধার সফল হয়েছে কিনা তা নির্দেশ করে। সম্ভাব্য মানগুলি হল OK বা FAILED। false
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের MCCMNC (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড টুপল) যা বর্তমানে মোবাইল ফোন নম্বরটি যে নেটওয়ার্কের অন্তর্গত তা শনাক্ত করে। true
mcc string(3) একটি তিন-অক্ষরের MCC (মোবাইল কান্ট্রি কোড) যা মোবাইল ফোন নম্বরের বর্তমান নেটওয়ার্কের সাথে সম্পর্কিত দেশকে প্রতিনিধিত্ব করে। true
mnc string(2|3) একটি দুই বা তিন অক্ষরের MNC (মোবাইল নেটওয়ার্ক কোড) যা মোবাইল ফোন নম্বরের বর্তমান নেটওয়ার্ক অপারেটরকে শনাক্ত করে। true
is_ported boolean ফোন নম্বরটি তার মূল নেটওয়ার্ক থেকে নতুন অপারেটরে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। true
original_network_name string পরীক্ষিত মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক অপারেটরের নাম নির্দিষ্ট করে একটি ইচ্ছামত স্ট্রিং (ইংরেজিতে)। true
original_country_name string পরীক্ষিত মোবাইল ফোন নম্বরের মূল দেশ নির্দেশ করে একটি ইচ্ছামত স্ট্রিং (ইংরেজিতে)। true
original_country_code string(2) পরীক্ষিত মোবাইল ফোন নম্বরের মূল দেশকে প্রতিনিধিত্বকারী একটি দুই-অক্ষরের ISO দেশের কোড। true
original_country_prefix string পরীক্ষিত মোবাইল ফোন নম্বরের সাথে সম্পর্কিত মূল দেশের ডায়ালিং কোড। true
ported_network_name string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে নেটওয়ার্ক অপারেটরে পোর্ট করা হয়েছে তা নির্দিষ্ট করে। true
ported_country_name string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে তা নির্দিষ্ট করে। true
ported_country_code string(2) প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে সেই দেশকে প্রতিনিধিত্বকারী একটি দুই-অক্ষরের ISO দেশের কোড। true
ported_country_prefix string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে সেই দেশের ডায়ালিং কোড। true
extra string ফোন নম্বর সম্পর্কে ঐচ্ছিক অতিরিক্ত বিবরণ প্রদানকারী একটি ইচ্ছামত স্ট্রিং। true
cost string একটি দশমিক মান, স্ট্রিং হিসাবে উপস্থাপিত, এই লুকআপের জন্য EUR-এ খরচ নির্দেশ করে। true
timestamp string একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প, টাইম জোন তথ্য সহ, লুকআপটি কখন সম্পন্ন হয়েছিল তা নির্দেশ করে। true
storage string স্টোরেজ নাম (বা রিপোর্ট নাম) যেখানে লুকআপ ফলাফল যুক্ত করা হয়েছিল। এটি CSV ডাউনলোড এবং ওয়েব ইন্টারফেসের মাধ্যমে রিপোর্টিংয়ের জন্য ব্যবহৃত হয়। true
route string(3) এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে একটি তিন-অক্ষরের শনাক্তকারী। true
error_code integer গ্রাহক সহায়তা নির্ণয়ের জন্য অতিরিক্ত প্রসঙ্গ প্রদানকারী একটি ঐচ্ছিক অভ্যন্তরীণ ত্রুটি কোড। true
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

POST/mnp-lookupsসুরক্ষিত

একটি অ্যাসিনক্রোনাস MNP (মোবাইল নম্বর পোর্টেবিলিটি) লুকআপের ব্যাচ শুরু করে, বর্তমান MCCMNC পুনরুদ্ধার করে এবং রিয়েল-টাইমে মূল এবং বর্তমান নেটওয়ার্ক সনাক্ত করে। ফলাফলগুলি ওয়েবহুকের মাধ্যমে আপনার সার্ভারে প্রদান করা হয়। এই পদ্ধতিটি বৃহৎ পরিমাণ নম্বর প্রক্রিয়াকরণের জন্য অপ্টিমাইজ করা হয়েছে যেগুলির তাৎক্ষণিক প্রতিক্রিয়ার প্রয়োজন নেই, যেমন ডেটাবেস পরিষ্কার এবং যাচাইকরণ। কল রাউটিং বা SMS ডেলিভারির মতো রিয়েল-টাইম অ্যাপ্লিকেশনের জন্য, পরিবর্তে POST /mnp-lookup এন্ডপয়েন্ট ব্যবহার করার কথা বিবেচনা করুন।

MNP কোয়েরি নির্ভরযোগ্যভাবে পোর্টেবিলিটি এবং নেটওয়ার্ক তথ্য নির্ধারণ করে কিন্তু লক্ষ্য মোবাইল ফোনটি বর্তমানে কোনো নেটওয়ার্কে সংযুক্ত এবং পৌঁছানোযোগ্য কিনা তা নির্দেশ করে না। লাইভ সংযোগ তথ্য নিষ্কাশন করতে, অনুগ্রহ করে POST /hlr-lookups এন্ডপয়েন্ট ব্যবহার করুন।

এই এন্ডপয়েন্ট ব্যবহার করার আগে, নিশ্চিত করুন যে লুকআপ ফলাফল অ্যাসিনক্রোনাসভাবে গ্রহণ করার জন্য একটি ওয়েবহুক URL কনফিগার করা আছে। আপনি এটি আপনার API সেটিংস-এ সেট আপ করতে পারেন।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স ওয়েবহুক
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/mnp-lookups' \
          -d "@payload.json"

পেলোড

application/json 
{
   "msisdns":["+14156226819","+491788735000","+905536939460"],
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdns array আন্তর্জাতিক ফরম্যাটে মোবাইল ফোন নম্বরের (MSISDNs) একটি অ্যারে (যেমন +14156226819 বা 0014156226819)। প্রতি অনুরোধে আপনি সর্বোচ্চ 1000টি নম্বর অন্তর্ভুক্ত করতে পারেন। null বাধ্যতামূলক
route string(3) একটি ঐচ্ছিক তিন-অক্ষরের আইডেন্টিফায়ার যা এই লুকআপের জন্য রুট নির্দিষ্ট করে। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে অথবা স্বয়ংক্রিয়ভাবে আমাদের সিস্টেমকে এই অনুরোধের জন্য সেরা রুট স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
   "accepted":[
      {
         "id":"0424928f332e",
         "msisdn":"+491788735000"
      }
   ],
   "accepted_count":1,
   "rejected":[
      {
         "id":null,
         "msisdn":"+31"
      }
   ],
   "rejected_count":1,
   "total_count":2,
   "cost":"0.01",
   "storage":"ASYNC-API-2020-08",
   "route":"IP1",
   "webhook_urls":[
      "https://your-server.com/endpoint"
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
accepted array প্রক্রিয়াকরণের জন্য গৃহীত অনন্য আইডেন্টিফায়ার এবং MSISDNs সমন্বিত অবজেক্টের একটি তালিকা। false
accepted_count integer প্রক্রিয়াকরণের জন্য সফলভাবে গৃহীত MSISDNs-এর মোট সংখ্যা। false
rejected array প্রক্রিয়াকরণের জন্য প্রত্যাখ্যাত অনন্য আইডেন্টিফায়ার এবং MSISDNs সমন্বিত অবজেক্টের একটি তালিকা, সাধারণত অবৈধ নম্বরের কারণে। প্রত্যাখ্যাত এন্ট্রিগুলির জন্য কোনো চার্জ প্রযোজ্য নয়। false
rejected_count integer যাচাইকরণ ত্রুটির কারণে প্রত্যাখ্যাত MSISDNs-এর মোট সংখ্যা। false
total_count integer প্রক্রিয়াকরণের জন্য জমা দেওয়া গৃহীত এবং প্রত্যাখ্যাত MSISDNs-এর মোট সংখ্যা। false
cost string একটি স্ট্রিং হিসাবে উপস্থাপিত দশমিক মান, যা গৃহীত লুকআপগুলির জন্য EUR-এ মোট খরচ নির্দেশ করে। false
storage string স্টোরেজের নাম যেখানে লুকআপ ফলাফল যুক্ত করা হয়, ওয়েব ইন্টারফেসের মাধ্যমে রিপোর্টিং এবং CSV ডাউনলোডের জন্য ব্যবহৃত। false
route string(3) এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে একটি তিন-অক্ষরের শনাক্তকারী। false
webhook_urls array আপনার API সেটিংস-এ কনফিগার করা ওয়েবহুক URL। ফলাফলগুলি এখানে পোস্ট করা হয়। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false

ওয়েবহুক প্রক্রিয়াকরণ

জমা দেওয়ার পর, আমাদের প্ল্যাটফর্ম প্রদত্ত ফোন নম্বরগুলি প্রক্রিয়া করা শুরু করে এবং ফলাফল আপনার সার্ভারে পূর্বনির্ধারিত ওয়েবহুক URL-এ পাঠায়। ফলাফলগুলি একটি HTTP POST রিকোয়েস্ট হিসাবে রিকোয়েস্ট বডিতে JSON অবজেক্টসহ প্রেরণ করা হয়।

প্রমাণীকরণ

X-Signatures HTTP হেডার পরীক্ষা করে ওয়েবহুক যাচাই করুন।

X-Signatures হেডারে সেমিকোলন দ্বারা পৃথক করা স্বাক্ষরের একটি তালিকা রয়েছে। তালিকার প্রতিটি স্বাক্ষর আপনার অ্যাকাউন্টে কনফিগার করা API সিক্রেটগুলির একটি ব্যবহার করে তৈরি করা হয়। ওয়েবহুক যাচাই করতে, আপনার API কী, সিক্রেট এবং রও HTTP বডি ব্যবহার করে একটি SHA-256 হ্যাশ তৈরি করুন - তারপর এটি তালিকার স্বাক্ষরগুলির সাথে তুলনা করুন।

একটি মিল নিশ্চিত করে যে রিকোয়েস্টটি প্রকৃত এবং আপনার নিয়ন্ত্রিত একটি সিক্রেট দিয়ে স্বাক্ষরিত।

PHP কোড উদাহরণ

PHP 
$signaturesHeader = (getallheaders() ?? [])['X-Signatures'] ?? ''; // list of signatures
$key = getenv('AUTH_KEY'); // Your API Key
$secret = getenv('AUTH_SECRET'); // Your API Secret
$payload = file_get_contents('php://input'); // The HTTP body of the incoming POST request

// Generate the expected signature
$expectedSignature = hash('sha256', $key . $secret . $payload);

// Split the header into individual signatures
$providedSignatures = explode(';', $signaturesHeader);

// Check if any signature matches
$valid = false;
foreach ($providedSignatures as $sig) {
    if (hash_equals($expectedSignature, $sig)) {
        $valid = true;
        break;
    }
}

রিকোয়েস্টটি বৈধ যদি হেডারে প্রদত্ত যেকোনো স্বাক্ষর আপনার API কী, সিক্রেট এবং HTTP বডির সংযুক্ত স্ট্রিং থেকে গণনা করা SHA256 হ্যাশের সমান হয়।

প্রাপ্তি নিশ্চিতকরণ

সফল প্রাপ্তি নিশ্চিত করতে আপনার সার্ভার থেকে HTTP স্ট্যাটাস কোড 200 OK দিয়ে প্রতিক্রিয়া প্রত্যাশিত। যদি অন্য কোনো রেসপন্স কোড ফেরত আসে, টাইমআউট ঘটে (১০ সেকেন্ড), বা অন্য কোনো ডেলিভারি সমস্যা দেখা দেয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে এক মিনিট পরে ওয়েবহুক পুনরায় চেষ্টা করবে। রিকোয়েস্ট ব্যর্থ হতে থাকলে, পুনঃপ্রচেষ্টা একটি এক্সপোনেনশিয়াল ব্যাকঅফ কৌশল অনুসরণ করবে, পরবর্তী প্রচেষ্টা 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024 মিনিট পরে হবে।

এই পুনঃপ্রচেষ্টা প্রক্রিয়া আপনার অবকাঠামোতে লুকআপ ফলাফল সরবরাহে সর্বোচ্চ নির্ভরযোগ্যতা নিশ্চিত করে। এটি অস্থায়ী নেটওয়ার্ক সমস্যা বা সার্ভার ডাউনটাইমের কারণে ডেটা হারানোর ঝুঁকি কমায়।

ওয়েবহুক পেলোড

HTTP POST (application/json) 
{
    "type":"MNP",
    "results":[
        {
           "id":"e428acb1c0ae",
           "msisdn":"+14156226819",
           "query_status":"OK",
           "mccmnc":"310260",
           "mcc":"310",
           "mnc":"260",
           "is_ported":true,
           "original_network_name":"Verizon Wireless:6006 - SVR/2",
           "original_country_name":"United States",
           "original_country_code":"US",
           "original_country_prefix":"+1415",
           "ported_network_name":"T-Mobile US:6529 - SVR/2",
           "ported_country_name":"United States",
           "ported_country_code":"US",
           "ported_country_prefix":"+1",
           "extra":"LRN:4154250000",
           "cost":"0.0050",
           "timestamp":"2020-08-05 21:21:33.490+0300",
           "storage":"WEB-CLIENT-SOLO-MNP-2020-08",
           "route":"PTX",
           "error_code":null
        }
    ]
}

ওয়েবহুক পেলোড অ্যাট্রিবিউটস

JSON অবজেক্টে একটি type => MNP অ্যাট্রিবিউটের পাশাপাশি একটি results অ্যাট্রিবিউট রয়েছে যাতে লুকআপ অবজেক্টের একটি তালিকা অন্তর্ভুক্ত থাকে, যা নিচে নথিভুক্ত করা হয়েছে।

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপের জন্য একটি অনন্য ১২-অক্ষরের শনাক্তকারী। false
msisdn string এই লুকআপ অনুরোধে মূল্যায়ন করা মোবাইল ফোন নম্বর। false
query_status string পোর্টেবিলিটি এবং নেটওয়ার্ক তথ্য পুনরুদ্ধার সফল হয়েছে কিনা তা নির্দেশ করে। সম্ভাব্য মানগুলি হল OK বা FAILED। false
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের MCCMNC (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড টুপল) যা বর্তমানে মোবাইল ফোন নম্বরটি যে নেটওয়ার্কের অন্তর্গত তা শনাক্ত করে। true
mcc string(3) একটি তিন-অক্ষরের MCC (মোবাইল কান্ট্রি কোড) যা মোবাইল ফোন নম্বরের বর্তমান নেটওয়ার্কের সাথে সম্পর্কিত দেশকে প্রতিনিধিত্ব করে। true
mnc string(2|3) একটি দুই বা তিন অক্ষরের MNC (মোবাইল নেটওয়ার্ক কোড) যা মোবাইল ফোন নম্বরের বর্তমান নেটওয়ার্ক অপারেটরকে শনাক্ত করে। true
is_ported boolean ফোন নম্বরটি তার মূল নেটওয়ার্ক থেকে নতুন অপারেটরে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। true
original_network_name string পরীক্ষিত মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক অপারেটরের নাম নির্দিষ্ট করে একটি ইচ্ছামত স্ট্রিং (ইংরেজিতে)। true
original_country_name string পরীক্ষিত মোবাইল ফোন নম্বরের মূল দেশ নির্দেশ করে একটি ইচ্ছামত স্ট্রিং (ইংরেজিতে)। true
original_country_code string(2) পরীক্ষিত মোবাইল ফোন নম্বরের মূল দেশকে প্রতিনিধিত্বকারী একটি দুই-অক্ষরের ISO দেশের কোড। true
original_country_prefix string পরীক্ষিত মোবাইল ফোন নম্বরের সাথে সম্পর্কিত মূল দেশের ডায়ালিং কোড। true
ported_network_name string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে নেটওয়ার্ক অপারেটরে পোর্ট করা হয়েছে তা নির্দিষ্ট করে। true
ported_country_name string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে তা নির্দিষ্ট করে। true
ported_country_code string(2) প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে সেই দেশকে প্রতিনিধিত্বকারী একটি দুই-অক্ষরের ISO দেশের কোড। true
ported_country_prefix string প্রযোজ্য হলে, পরীক্ষিত মোবাইল ফোন নম্বরটি যে দেশে পোর্ট করা হয়েছে সেই দেশের ডায়ালিং কোড। true
extra string ফোন নম্বর সম্পর্কে ঐচ্ছিক অতিরিক্ত বিবরণ প্রদানকারী একটি ইচ্ছামত স্ট্রিং। true
cost string একটি দশমিক মান, স্ট্রিং হিসাবে উপস্থাপিত, এই লুকআপের জন্য EUR-এ খরচ নির্দেশ করে। true
timestamp string একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প, টাইম জোন তথ্য সহ, লুকআপটি কখন সম্পন্ন হয়েছিল তা নির্দেশ করে। true
storage string স্টোরেজ নাম (বা রিপোর্ট নাম) যেখানে লুকআপ ফলাফল যুক্ত করা হয়েছিল। এটি CSV ডাউনলোড এবং ওয়েব ইন্টারফেসের মাধ্যমে রিপোর্টিংয়ের জন্য ব্যবহৃত হয়। true
route string(3) এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে একটি তিন-অক্ষরের শনাক্তকারী। true
error_code integer গ্রাহক সহায়তা নির্ণয়ের জন্য অতিরিক্ত প্রসঙ্গ প্রদানকারী একটি ঐচ্ছিক অভ্যন্তরীণ ত্রুটি কোড। true
উপরে স্ক্রল করুন

POST/nt-lookupসুরক্ষিত

একটি সিঙ্ক্রোনাস নম্বর টাইপ (NT) লুকআপ সম্পাদন করে। প্রদত্ত ফোন নম্বরগুলি ল্যান্ডলাইন, মোবাইল, প্রিমিয়াম রেট, VoIP, পেজার বা অন্যান্য নম্বরিং প্ল্যান রেঞ্জের অন্তর্গত কিনা তা রিয়েল-টাইমে নির্ধারণ করা আপনার প্রধান লক্ষ্য হলে এই এন্ডপয়েন্টটি আদর্শ।

NT কোয়েরিগুলি নির্ভরযোগ্যভাবে ফোন নম্বরের ধরন সনাক্ত করে; তবে, এগুলি নির্দেশ করে না যে লক্ষ্য নম্বরটি বর্তমানে কোনো নেটওয়ার্কের সাথে সংযুক্ত এবং পৌঁছানোযোগ্য কিনা। লাইভ সংযোগ তথ্য পেতে, অনুগ্রহ করে POST /hlr-lookup এন্ডপয়েন্ট ব্যবহার করুন।

আপনার ব্যবহারের ক্ষেত্রে যদি সঠিক নেটওয়ার্ক এবং পোর্টেবিলিটি তথ্য (MCCMNC) প্রয়োজন হয় কিন্তু লাইভ সংযোগ স্ট্যাটাস নয়, তাহলে মোবাইল নম্বর পোর্টেবিলিটি কোয়েরির জন্য অনুগ্রহ করে POST /mnp-lookup এন্ডপয়েন্ট ব্যবহার করুন।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স টাইপ রেফারেন্স
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/nt-lookup' \
          -d "@payload.json"

পেলোড

application/json 
{
   "number":"+14156226819",
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
number string আন্তর্জাতিক ফরম্যাটে একটি ফোন নম্বর (যেমন +4989702626 বা 004989702626)। null mandatory
route string(3) এই লুকআপের জন্য রুট নির্দিষ্ট করে এমন একটি ঐচ্ছিক তিন-অক্ষরের শনাক্তকারী। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে বা আমাদের সিস্টেমকে এই অনুরোধের জন্য সেরা রুটগুলি স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null-এ সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
     "id":"2ed0788379c6",
     "number":"+4989702626",
     "number_type":"LANDLINE",
     "query_status":"OK",
     "is_valid":true,
     "invalid_reason":null,
     "is_possibly_ported":false,
     "is_vanity_number":false,
     "qualifies_for_hlr_lookup":false,
     "mccmnc":null,
     "mcc":null,
     "mnc":null,
     "original_network_name":null,
     "original_country_name":"Germany",
     "original_country_code":"DE",
     "regions":[
        "Munich"
     ],
     "timezones":[
        "Europe/Berlin"
     ],
     "info_text":"This is a landline number.",
     "cost":"0.0050",
     "timestamp":"2015-12-04 10:36:41.866283+00",
     "storage":"SYNC-API-NT-2015-12",
     "route":"LC1"
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপ অনুরোধের জন্য নির্ধারিত একটি অনন্য শনাক্তকারী। false
number string এই লুকআপ অনুরোধের সময় যে ফোন নম্বরটি মূল্যায়ন করা হয়েছিল। false
number_type string সনাক্তকৃত নম্বরের ধরন। সম্ভাব্য মানগুলির মধ্যে রয়েছে: LANDLINE , MOBILE , MOBILE_OR_LANDLINE , TOLL_FREE , PREMIUM_RATE , SHARED_COST , VOIP , PAGER , UAN , VOICEMAIL , UNKNOWN । false
query_status string নম্বরের ধরনের তথ্য সফলভাবে প্রাপ্ত হয়েছে কিনা তা নির্দেশ করে। সফল হলে OK রিটার্ন করে, অথবা লুকআপ ব্যর্থ হলে FAILED রিটার্ন করে। false
is_valid boolean ফোন নম্বরটি সিনট্যাক্টিক্যালি বৈধ কিনা তা নির্দেশ করে। true
invalid_reason string একটি ইংরেজি প্লেইন টেক্সট বার্তা যা নির্দিষ্ট করে কেন ফোন নম্বরটি অবৈধ বলে বিবেচিত হয়েছে (যেমন "too short" বা "invalid prefix"), অথবা নম্বরটি বৈধ হলে null। true
is_possibly_ported boolean ফোন নম্বরটি তার মূল অপারেটর থেকে অন্য ক্যারিয়ারে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। নিশ্চিত পোর্টেবিলিটি তথ্যের জন্য, MNP লুকআপ ব্যবহার করুন। true
is_vanity_number boolean ফোন নম্বরটি ভ্যানিটি নম্বর কিনা তা নির্দেশ করে, অর্থাৎ এতে বর্ণমালা অক্ষর রয়েছে। true
qualifies_for_hlr_lookup boolean ফোন নম্বরটি HLR লুকআপের মাধ্যমে অতিরিক্ত কোয়েরির জন্য যোগ্য কিনা তা নির্দেশ করে। true
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের স্ট্রিং যা MCCMNC টাপল (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড) প্রতিনিধিত্ব করে যা মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক সনাক্ত করে। true
mcc string(3) একটি তিন অক্ষরের স্ট্রিং যা MCC (মোবাইল কান্ট্রি কোড) প্রতিনিধিত্ব করে যা ফোন নম্বরের মূল মোবাইল নেটওয়ার্কের সাথে সম্পর্কিত দেশ সনাক্ত করে। true
mnc string(2|3) একটি দুই বা তিন অক্ষরের স্ট্রিং যা MNC (মোবাইল নেটওয়ার্ক কোড) প্রতিনিধিত্ব করে যা ফোন নম্বরের মূল মোবাইল নেটওয়ার্ক অপারেটর সনাক্ত করে। true
original_network_name string একটি ইংরেজি প্লেইন টেক্সট স্ট্রিং যা পরিদর্শিত মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক অপারেটরের নাম নির্দিষ্ট করে। true
original_country_name string একটি ইংরেজি প্লেইন টেক্সট স্ট্রিং যা পরিদর্শিত মোবাইল ফোন নম্বরের সাথে সম্পর্কিত মূল দেশ নির্দিষ্ট করে। true
original_country_code string(2) একটি দুই অক্ষরের ISO দেশ কোড যা পরিদর্শিত মোবাইল ফোন নম্বরের মূল দেশ নির্দেশ করে। true
regions array ইংরেজিতে মানব-পাঠযোগ্য স্ট্রিংগুলির একটি তালিকা যা এই ফোন নম্বরের সাথে সম্পর্কিত ভৌগোলিক অঞ্চল(গুলি) নির্দিষ্ট করে। true
timezones array এই ফোন নম্বরের সাথে সম্পর্কিত টাইমজোনগুলির (Olson ফরম্যাটে) একটি তালিকা। true
info_text string একটি স্ট্রিং যা ফোন নম্বর সম্পর্কে অতিরিক্ত তথ্য ধারণ করতে পারে। true
cost string একটি স্ট্রিং হিসাবে প্রতিনিধিত্ব করা দশমিক মান, যা এই লুকআপের খরচ (EUR-এ) নির্দেশ করে। true
timestamp string একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প (টাইম জোন সহ) যা নির্দেশ করে কখন লুকআপটি সম্পন্ন হয়েছিল। true
storage string স্টোরেজের নাম নির্দিষ্ট করে যেখানে লুকআপ ফলাফল যুক্ত করা হয়েছে। এটি CSV ডাউনলোড এবং ওয়েব ইন্টারফেসের মাধ্যমে অ্যানালিটিক্সের জন্য ব্যবহৃত রিপোর্ট নামের সাথে সংশ্লিষ্ট। true
route string(3) এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে একটি তিন-অক্ষরের শনাক্তকারী। true
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
টাইপ বিবরণ
LANDLINE ল্যান্ডলাইন ফোন নম্বর।
MOBILE মোবাইল ফোন নম্বর। সংযোগ অবস্থা, নেটওয়ার্ক, পোর্টেবিলিটি এবং রোমিং তথ্য পেতে HLR লুকআপের জন্য যোগ্য।
MOBILE_OR_LANDLINE ল্যান্ডলাইন অথবা মোবাইল ফোন নম্বর। HLR লুকআপের জন্য যোগ্য হতে পারে।
TOLL_FREE টোল ফ্রি ফোন নম্বর।
PREMIUM_RATE অতিরিক্ত চার্জ সহ প্রিমিয়াম রেট ফোন নম্বর।
SHARED_COST শেয়ারড কস্ট ফোন নম্বর। সাধারণত প্রিমিয়াম রেট ফোন নম্বরের চেয়ে কম খরচে।
VOIP ভয়েস ওভার আইপি ফোন নম্বর। TSoIP ফোন নম্বর (টেলিফোনি সার্ভিস ওভার আইপি) অন্তর্ভুক্ত।
PAGER পেজার ফোন নম্বর। সাধারণত কোনো ভয়েস কার্যকারিতা নেই।
UAN ইউনিভার্সাল অ্যাক্সেস নম্বর (কোম্পানি নম্বর)। নির্দিষ্ট অফিসে রুট করা হতে পারে তবে কোম্পানির জন্য একটি নম্বর ব্যবহার করার সুবিধা দেয়।
VOICEMAIL ভয়েসমেইল ফোন নম্বর।
UNKNOWN নম্বরের ধরন নির্ধারণ করা যায়নি।
উপরে স্ক্রল করুন

POST/nt-lookups সুরক্ষিত

এই এন্ডপয়েন্টটি ওয়েবহুকের মাধ্যমে আপনার সার্ভারে ফলাফল পোস্ট করার সাথে সাথে একাধিক অ্যাসিনক্রোনাস নম্বর টাইপ লুকআপ চালু করে। প্রদত্ত ফোন নম্বরগুলি ল্যান্ডলাইন, মোবাইল, প্রিমিয়াম রেট, ভিওআইপি, পেজার বা অন্যান্য নম্বরিং পরিকল্পনা রেঞ্জের অন্তর্গত কিনা তা নির্ধারণ করা আপনার প্রধান লক্ষ্য হলে এটি উপযুক্ত। বৃহৎ পরিমাণ নম্বরের দ্রুত প্রক্রিয়াকরণের জন্য অপটিমাইজড, এই এন্ডপয়েন্টটি বাল্ক অপারেশনের জন্য আদর্শ (যেমন ডেটাবেস স্যানিটাইজেশন)। লাইভ ট্রাফিক এবং সময়-সংবেদনশীল ব্যবহারের ক্ষেত্রে, অনুগ্রহ করে পরিবর্তে POST /nt-lookup এন্ডপয়েন্ট ব্যবহার করুন।

এই এন্ডপয়েন্ট চালু করার পূর্বশর্ত হিসাবে আপনাকে আপনার API সেটিংসে একটি ওয়েবহুক URL নির্দিষ্ট করতে হবে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স ওয়েবহুক টাইপ রেফারেন্স
cURL 
curl -X POST 'https://www.hlr-lookups.com/api/v2/nt-lookups' \
          -d "@payload.json"

পেলোড

application/json 
{
   "numbers":["+14156226819","+4989702626"],
   "route":null,
   "storage":null
}

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
numbers array আন্তর্জাতিক ফরম্যাটে ফোন নম্বরের একটি অ্যারে (যেমন +14156226819 অথবা 004989702626)। প্রতি অনুরোধে সর্বোচ্চ 1000টি নম্বর অন্তর্ভুক্ত করা যাবে। null বাধ্যতামূলক
route string(3) এই লুকআপের জন্য রুট নির্দিষ্ট করে একটি ঐচ্ছিক তিন-অক্ষরের শনাক্তকারী। আপনার কাস্টম রাউটিং ম্যাপ প্রয়োগ করতে বা আমাদের সিস্টেমকে এই অনুরোধের জন্য সর্বোত্তম রুট স্বয়ংক্রিয়ভাবে নির্ধারণ করতে দিতে null-তে সেট করুন বা এই প্যারামিটারটি বাদ দিন। null ঐচ্ছিক
storage string একটি ঐচ্ছিক স্টোরেজ আইডেন্টিফায়ার যা রিপোর্ট নির্দিষ্ট করে যেখানে ফলাফলগুলি ম্যানুয়াল পর্যালোচনা, বিশ্লেষণ এবং রিপোর্টিংয়ের জন্য সংরক্ষণ করা হবে। সিস্টেম স্বয়ংক্রিয়ভাবে বর্তমান মাসের সাথে একটি টাইমস্ট্যাম্প যুক্ত করে। যদি বাদ দেওয়া হয় বা null-এ সেট করা হয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে রিপোর্টিংয়ের উদ্দেশ্যে মাস অনুসারে ফলাফলগুলি গ্রুপ করবে। null ঐচ্ছিক
200 OK 
{
   "accepted":[
      {
         "id":"9f8a52cfa7d2",
         "number":"+905536939460"
      }
   ],
   "accepted_count":1,
   "rejected":[
      {
         "id":null,
         "number":"+31"
      }
   ],
   "rejected_count":2,
   "total_count":3,
   "cost":0.005,
   "storage":"ASYNC-API-NT-2020-08",
   "route":"LC1",
   "webhook_urls":[
      "https://your-server.com/endpoint"
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
accepted array অবজেক্টের একটি অ্যারে, যার প্রতিটিতে একটি অনন্য শনাক্তকারী এবং একটি ফোন নম্বর রয়েছে যা প্রক্রিয়াকরণের জন্য গৃহীত হয়েছে। false
accepted_count integer প্রক্রিয়াকরণের জন্য গৃহীত ফোন নম্বরের মোট সংখ্যা। false
rejected array অবজেক্টের একটি অ্যারে, যার প্রতিটিতে একটি অনন্য শনাক্তকারী এবং একটি ফোন নম্বর রয়েছে যা প্রক্রিয়াকরণের জন্য প্রত্যাখ্যান করা হয়েছে। সাধারণত, এই নম্বরগুলি অবৈধ এবং কোনো চার্জ প্রয়োগ করা হয় না। false
rejected_count integer প্রক্রিয়াকরণের জন্য প্রত্যাখ্যাত ফোন নম্বরের মোট সংখ্যা। false
total_count integer প্রক্রিয়াকরণের জন্য জমা দেওয়া গৃহীত এবং প্রত্যাখ্যাত ফোন নম্বরের মোট সংখ্যা। false
cost string একটি স্ট্রিং যা দশমিক মান উপস্থাপন করে যা এই লুকআপগুলির জন্য EUR-এ খরচ নির্দেশ করে। false
storage string স্টোরেজ (রিপোর্ট) এর নাম যেখানে লুকআপ ফলাফল সংযুক্ত করা হয়েছে। এই নামটি ওয়েব ইন্টারফেসের মাধ্যমে CSV ডাউনলোড এবং অ্যানালিটিক্সের জন্য ব্যবহৃত হয়। false
route string(3) একটি তিন-অক্ষরের শনাক্তকারী যা এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে। false
webhook_urls array আপনার API সেটিংস-এ কনফিগার করা ওয়েবহুক URL। ফলাফলগুলি এখানে পোস্ট করা হয়। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false

ওয়েবহুক প্রক্রিয়াকরণ

জমা দেওয়ার পর, আমাদের প্ল্যাটফর্ম প্রদত্ত ফোন নম্বরগুলি প্রক্রিয়া করা শুরু করে এবং ফলাফল আপনার সার্ভারে পূর্বনির্ধারিত ওয়েবহুক URL-এ পাঠায়। ফলাফলগুলি একটি HTTP POST রিকোয়েস্ট হিসাবে রিকোয়েস্ট বডিতে JSON অবজেক্টসহ প্রেরণ করা হয়।

প্রমাণীকরণ

X-Signatures HTTP হেডার পরীক্ষা করে ওয়েবহুক যাচাই করুন।

X-Signatures হেডারে সেমিকোলন দ্বারা পৃথক করা স্বাক্ষরের একটি তালিকা রয়েছে। তালিকার প্রতিটি স্বাক্ষর আপনার অ্যাকাউন্টে কনফিগার করা API সিক্রেটগুলির একটি ব্যবহার করে তৈরি করা হয়। ওয়েবহুক যাচাই করতে, আপনার API কী, সিক্রেট এবং রও HTTP বডি ব্যবহার করে একটি SHA-256 হ্যাশ তৈরি করুন - তারপর এটি তালিকার স্বাক্ষরগুলির সাথে তুলনা করুন।

একটি মিল নিশ্চিত করে যে রিকোয়েস্টটি প্রকৃত এবং আপনার নিয়ন্ত্রিত একটি সিক্রেট দিয়ে স্বাক্ষরিত।

PHP কোড উদাহরণ

PHP 
$signaturesHeader = (getallheaders() ?? [])['X-Signatures'] ?? ''; // list of signatures
$key = getenv('AUTH_KEY'); // Your API Key
$secret = getenv('AUTH_SECRET'); // Your API Secret
$payload = file_get_contents('php://input'); // The HTTP body of the incoming POST request

// Generate the expected signature
$expectedSignature = hash('sha256', $key . $secret . $payload);

// Split the header into individual signatures
$providedSignatures = explode(';', $signaturesHeader);

// Check if any signature matches
$valid = false;
foreach ($providedSignatures as $sig) {
    if (hash_equals($expectedSignature, $sig)) {
        $valid = true;
        break;
    }
}

রিকোয়েস্টটি বৈধ যদি হেডারে প্রদত্ত যেকোনো স্বাক্ষর আপনার API কী, সিক্রেট এবং HTTP বডির সংযুক্ত স্ট্রিং থেকে গণনা করা SHA256 হ্যাশের সমান হয়।

প্রাপ্তি নিশ্চিতকরণ

সফল প্রাপ্তি নিশ্চিত করতে আপনার সার্ভার থেকে HTTP স্ট্যাটাস কোড 200 OK দিয়ে প্রতিক্রিয়া প্রত্যাশিত। যদি অন্য কোনো রেসপন্স কোড ফেরত আসে, টাইমআউট ঘটে (১০ সেকেন্ড), বা অন্য কোনো ডেলিভারি সমস্যা দেখা দেয়, তাহলে সিস্টেম স্বয়ংক্রিয়ভাবে এক মিনিট পরে ওয়েবহুক পুনরায় চেষ্টা করবে। রিকোয়েস্ট ব্যর্থ হতে থাকলে, পুনঃপ্রচেষ্টা একটি এক্সপোনেনশিয়াল ব্যাকঅফ কৌশল অনুসরণ করবে, পরবর্তী প্রচেষ্টা 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024 মিনিট পরে হবে।

এই পুনঃপ্রচেষ্টা প্রক্রিয়া আপনার অবকাঠামোতে লুকআপ ফলাফল সরবরাহে সর্বোচ্চ নির্ভরযোগ্যতা নিশ্চিত করে। এটি অস্থায়ী নেটওয়ার্ক সমস্যা বা সার্ভার ডাউনটাইমের কারণে ডেটা হারানোর ঝুঁকি কমায়।

ওয়েবহুক পেলোড

HTTP POST (application/json) 
{
   "type":"NT",
   "results":[
      {
         "id":"9f8a52cfa7d2",
         "number":"+905536939460",
         "numbertype":"MOBILE",
         "state":"COMPLETED",
         "isvalid":"Yes",
         "invalidreason":null,
         "ispossiblyported":"Yes",
         "isvanitynumber":"No",
         "qualifiesforhlrlookup":"Yes",
         "originalcarrier":"Turk Telekom (AVEA)",
         "mccmnc":"28603",
         "mcc":"286",
         "mnc":"03",
         "countrycode":"TR",
         "regions":[
            "Turkey"
         ],
         "timezones":[
            "Europe\/Istanbul"
         ],
         "infotext":"This number qualifies for HLR lookups. Determine if this subscriber number is connected, absent or invalid by running an HLR lookup. This is a mobile number and might be in roaming state. Run an HLR lookup to obtain roaming information (if available). This number is possibly ported and the carrier information might be inaccurate. To obtain portability information run an HLR lookup.",
         "usercharge":"0.0050",
         "inserttime":"2020-08-13 01:57:15.897+0300",
         "storage":"ASYNC-API-NT-2020-08",
         "route":"LC1",
         "interface":"Async API"
      }
   ]
}

ওয়েবহুক পেলোড অ্যাট্রিবিউটস

JSON অবজেক্টে একটি type => NT অ্যাট্রিবিউটের পাশাপাশি একটি results অ্যাট্রিবিউট রয়েছে যাতে লুকআপ অবজেক্টের একটি তালিকা অন্তর্ভুক্ত থাকে, যা নিচে নথিভুক্ত করা হয়েছে।

নাম টাইপ বিবরণ নালযোগ্য
id string(12) এই লুকআপ অনুরোধের জন্য নির্ধারিত একটি অনন্য শনাক্তকারী। false
number string এই লুকআপ অনুরোধের সময় যে ফোন নম্বরটি মূল্যায়ন করা হয়েছিল। false
number_type string সনাক্তকৃত নম্বরের ধরন। সম্ভাব্য মানগুলির মধ্যে রয়েছে: LANDLINE , MOBILE , MOBILE_OR_LANDLINE , TOLL_FREE , PREMIUM_RATE , SHARED_COST , VOIP , PAGER , UAN , VOICEMAIL , UNKNOWN । false
query_status string নম্বরের ধরনের তথ্য সফলভাবে প্রাপ্ত হয়েছে কিনা তা নির্দেশ করে। সফল হলে OK রিটার্ন করে, অথবা লুকআপ ব্যর্থ হলে FAILED রিটার্ন করে। false
is_valid boolean ফোন নম্বরটি সিনট্যাক্টিক্যালি বৈধ কিনা তা নির্দেশ করে। true
invalid_reason string একটি ইংরেজি প্লেইন টেক্সট বার্তা যা নির্দিষ্ট করে কেন ফোন নম্বরটি অবৈধ বলে বিবেচিত হয়েছে (যেমন "too short" বা "invalid prefix"), অথবা নম্বরটি বৈধ হলে null। true
is_possibly_ported boolean ফোন নম্বরটি তার মূল অপারেটর থেকে অন্য ক্যারিয়ারে পোর্ট করা হয়েছে কিনা তা নির্দেশ করে। নিশ্চিত পোর্টেবিলিটি তথ্যের জন্য, MNP লুকআপ ব্যবহার করুন। true
is_vanity_number boolean ফোন নম্বরটি ভ্যানিটি নম্বর কিনা তা নির্দেশ করে, অর্থাৎ এতে বর্ণমালা অক্ষর রয়েছে। true
qualifies_for_hlr_lookup boolean ফোন নম্বরটি HLR লুকআপের মাধ্যমে অতিরিক্ত কোয়েরির জন্য যোগ্য কিনা তা নির্দেশ করে। true
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের স্ট্রিং যা MCCMNC টাপল (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড) প্রতিনিধিত্ব করে যা মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক সনাক্ত করে। true
mcc string(3) একটি তিন অক্ষরের স্ট্রিং যা MCC (মোবাইল কান্ট্রি কোড) প্রতিনিধিত্ব করে যা ফোন নম্বরের মূল মোবাইল নেটওয়ার্কের সাথে সম্পর্কিত দেশ সনাক্ত করে। true
mnc string(2|3) একটি দুই বা তিন অক্ষরের স্ট্রিং যা MNC (মোবাইল নেটওয়ার্ক কোড) প্রতিনিধিত্ব করে যা ফোন নম্বরের মূল মোবাইল নেটওয়ার্ক অপারেটর সনাক্ত করে। true
original_network_name string একটি ইংরেজি প্লেইন টেক্সট স্ট্রিং যা পরিদর্শিত মোবাইল ফোন নম্বরের মূল নেটওয়ার্ক অপারেটরের নাম নির্দিষ্ট করে। true
original_country_name string একটি ইংরেজি প্লেইন টেক্সট স্ট্রিং যা পরিদর্শিত মোবাইল ফোন নম্বরের সাথে সম্পর্কিত মূল দেশ নির্দিষ্ট করে। true
original_country_code string(2) একটি দুই অক্ষরের ISO দেশ কোড যা পরিদর্শিত মোবাইল ফোন নম্বরের মূল দেশ নির্দেশ করে। true
regions array ইংরেজিতে মানব-পাঠযোগ্য স্ট্রিংগুলির একটি তালিকা যা এই ফোন নম্বরের সাথে সম্পর্কিত ভৌগোলিক অঞ্চল(গুলি) নির্দিষ্ট করে। true
timezones array এই ফোন নম্বরের সাথে সম্পর্কিত টাইমজোনগুলির (Olson ফরম্যাটে) একটি তালিকা। true
info_text string একটি স্ট্রিং যা ফোন নম্বর সম্পর্কে অতিরিক্ত তথ্য ধারণ করতে পারে। true
cost string একটি স্ট্রিং হিসাবে প্রতিনিধিত্ব করা দশমিক মান, যা এই লুকআপের খরচ (EUR-এ) নির্দেশ করে। true
timestamp string একটি W3C-ফরম্যাটেড টাইমস্ট্যাম্প (টাইম জোন সহ) যা নির্দেশ করে কখন লুকআপটি সম্পন্ন হয়েছিল। true
storage string স্টোরেজের নাম নির্দিষ্ট করে যেখানে লুকআপ ফলাফল যুক্ত করা হয়েছে। এটি CSV ডাউনলোড এবং ওয়েব ইন্টারফেসের মাধ্যমে অ্যানালিটিক্সের জন্য ব্যবহৃত রিপোর্ট নামের সাথে সংশ্লিষ্ট। true
route string(3) এই লুকআপ অনুরোধের জন্য ব্যবহৃত রুট নির্দিষ্ট করে একটি তিন-অক্ষরের শনাক্তকারী। true
টাইপ বিবরণ
LANDLINE ল্যান্ডলাইন ফোন নম্বর।
MOBILE মোবাইল ফোন নম্বর। সংযোগ অবস্থা, নেটওয়ার্ক, পোর্টেবিলিটি এবং রোমিং তথ্য পেতে HLR লুকআপের জন্য যোগ্য।
MOBILE_OR_LANDLINE ল্যান্ডলাইন অথবা মোবাইল ফোন নম্বর। HLR লুকআপের জন্য যোগ্য হতে পারে।
TOLL_FREE টোল ফ্রি ফোন নম্বর।
PREMIUM_RATE অতিরিক্ত চার্জ সহ প্রিমিয়াম রেট ফোন নম্বর।
SHARED_COST শেয়ারড কস্ট ফোন নম্বর। সাধারণত প্রিমিয়াম রেট ফোন নম্বরের চেয়ে কম খরচে।
VOIP ভয়েস ওভার আইপি ফোন নম্বর। TSoIP ফোন নম্বর (টেলিফোনি সার্ভিস ওভার আইপি) অন্তর্ভুক্ত।
PAGER পেজার ফোন নম্বর। সাধারণত কোনো ভয়েস কার্যকারিতা নেই।
UAN ইউনিভার্সাল অ্যাক্সেস নম্বর (কোম্পানি নম্বর)। নির্দিষ্ট অফিসে রুট করা হতে পারে তবে কোম্পানির জন্য একটি নম্বর ব্যবহার করার সুবিধা দেয়।
VOICEMAIL ভয়েসমেইল ফোন নম্বর।
UNKNOWN নম্বরের ধরন নির্ধারণ করা যায়নি।
উপরে স্ক্রল করুন

GET/routeসুরক্ষিত

route প্যারামিটার নির্দিষ্ট না করে HLR লুকআপ চালানোর সময় যে রুটটি স্বয়ংক্রিয়ভাবে নির্বাচিত হবে তা পুনরুদ্ধার করে।

স্বয়ংক্রিয় রুট নির্বাচন GET /hlr-coverage এন্ডপয়েন্টের মাধ্যমে পুনরুদ্ধারযোগ্য রাউটিং ম্যাপের উপর ভিত্তি করে, যা মূলত GET /routing-map থেকে প্রাপ্ত। আপনি আপনার অ্যাকাউন্ট সেটিংসে আপনার রাউটিং ম্যাপ কাস্টমাইজ করতে এবং কাস্টম নিয়ম নির্ধারণ করতে পারেন।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/route?msisdn=+491788735000'

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdn string যে MSISDN-এর জন্য স্বয়ংক্রিয়ভাবে নির্বাচিত রাউটিং তথ্য পুনরুদ্ধার করতে হবে। null বাধ্যতামূলক
200 OK 
{
   "route":"V11",
   "confidence_level":"HIGH",
   "mccmnc":"26203",
   "origin":"SCORE"
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
route string প্রস্তাবিত রুট। false
confidence_level string যে আত্মবিশ্বাসের স্তরে এই রুট নির্বাচিত হয়েছিল, অর্থাৎ LOW, NORMAL, HIGH, MNP_FALLBACK। false
mccmnc string এই নম্বরের জন্য নাম্বারিং প্ল্যান ভিত্তিক MCCMNC। false
origin string যে উৎসের উপর রাউটিং সিদ্ধান্ত ভিত্তি করে নেওয়া হয়, অর্থাৎ SCORE, CUSTOM_GLOBAL_COUNTRY, CUSTOM_GLOBAL_MCCMNC, CUSTOM_GLOBAL_PREFIX, CUSTOM_USER_COUNTRY, CUSTOM_USER_MCCMNC, CUSTOM_USER_PREFIX, MNP_FALLBACK, PLATFORM_DEFAULT, USER_DEFAULT false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/routesসুরক্ষিত

এই এন্ডপয়েন্ট উপলব্ধ HLR, MNP এবং NT রুটের তালিকা প্রদান করে। প্রতিটি রুট এবং এর বৈশিষ্ট্য ও সীমাবদ্ধতা রাউটিং বিস্তারিত পৃষ্ঠায় ব্যাখ্যা করা হয়েছে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/routes'
200 OK 
{
   "routes":{
      "HLR":[
         "V11",
         "E10",
         "MS9",
         "DV8",
         "SV3",
         "IP1"
      ],
      "MNP":[
         "PTX",
         "IP4"
      ],
      "NT":[
         "LC1"
      ]
   }
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
routes object রুট টাইপ অনুযায়ী গ্রুপকৃত রুটসহ একটি অবজেক্ট। false
HLR|MNP|NT string[] রুট আইডেন্টিফায়ারের তালিকা রয়েছে। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/routing-mapসুরক্ষিত

আপনার অ্যাকাউন্টের জন্য বর্তমানে HLR লুকআপে প্রয়োগ করা স্বয়ংক্রিয় রাউটিং কনফিগারেশন পুনরুদ্ধার করে। এই ডিফল্ট কনফিগারেশনটি ব্যবহার করা হয় যখনই আপনি route প্যারামিটার নির্দিষ্ট না করে HLR লুকআপ জমা দেন। আপনি আপনার রাউটিং ম্যাপ কাস্টমাইজ করতে এবং আপনার অ্যাকাউন্ট সেটিংসে কাস্টম নিয়ম তৈরি করতে পারেন।

কনফিগারেশন হায়ারার্কি দেশ-স্তরের নিয়ম থেকে MCCMNC-স্তরের নিয়ম এবং সবশেষে পৃথক ফোন নম্বর প্রিফিক্স ম্যাপিং পর্যন্ত ক্যাসকেড করে। বাস্তবে, এর মানে হল পৃথক ফোন নম্বর প্রিফিক্স ম্যাপিং দ্বন্দ্বপূর্ণ MCCMNC অ্যাসাইনমেন্টের উপর অগ্রাধিকার পায়, যা পরবর্তীতে দেশ-স্তরের নিয়মগুলিকে ওভাররাইড করে। অনুগ্রহ করে মনে রাখবেন যে MNP ফলব্যাক সক্রিয় থাকাকালীন যেকোনো দ্বন্দ্বপূর্ণ কাস্টম নিয়মকে ওভাররাইড করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/routing-map'
200 OK 
{
   "routing":{
      "map":{
         "defaultRoute":"V11",
         "mnpFallback":true,
         "mccmncs":[
            {
               "mccmnc":20201,
               "countrycode":"GR",
               "route":"E10",
               "mno":"Cosmote",
               "confidence":"HIGH",
               "origin":"SCORE"
            }
         ],
         "prefixes":[
            {
               "countrycode":"DE",
               "cns":"+4917821",
               "route":"DV8",
               "mccmnc":"26203",
               "mno":"O2"
            }
         ],
         "countries":[
            {
               "countrycode":"US",
               "route":"DV8"
            }
         ]
      }
   }
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
default_route string ডিফল্ট রাউট যা ব্যবহৃত হয় যখন একটি MSISDN-এর জন্য কোনো পছন্দের রাউটিং অপশন নির্ধারণ করা যায় না এবং কোনো কাস্টম রাউটিং নিয়ম প্রযোজ্য হয় না। false
mnp_fallback boolean MNP ফলব্যাক সক্রিয় আছে কিনা তা নির্দেশ করে। সক্রিয় থাকলে এবং HLR কোয়েরি একটি নেটওয়ার্ক দ্বারা সমর্থিত না হলে (সংযোগ স্ট্যাটাস অনুপলব্ধ), সিস্টেম পরিবর্তে একটি MNP লুকআপ সম্পাদন করবে। false
mccmncs array MCCMNC কোডের একটি ম্যাপিং তাদের স্বয়ংক্রিয়ভাবে নির্বাচিত রাউটের সাথে। একটি নির্দিষ্ট MCCMNC-তে একটি নম্বরের জন্য HLR লুকআপ সম্পাদন করার সময়, সংশ্লিষ্ট রাউট ব্যবহার করা হয়। false
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের MCCMNC (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড সমন্বয়) যা মোবাইল নেটওয়ার্ক অপারেটরকে শনাক্ত করে। false
countrycode string(2) একটি দুই অক্ষরের ISO দেশ কোড, যা নেটওয়ার্কের দেশ চিহ্নিত করে। false
route string(3) নেটওয়ার্কের জন্য নির্বাচিত রাউট। false
mno string ভোক্তা-মুখী ব্র্যান্ড যার অধীনে এই নেটওয়ার্ক পরিচালিত হয়। false
confidence string যে আত্মবিশ্বাসের স্তরে নির্বাচন করা হয়েছিল। সম্ভাব্য মানগুলি হল: HIGH, NORMAL, LOW, MNP_REDIRECT। পরবর্তীটির ক্ষেত্রে, সিস্টেম এই নেটওয়ার্কে ট্রাফিক MNP-তে রিডাইরেক্ট করে, যদি এই আচরণ আপনার অ্যাকাউন্টে সক্রিয় থাকে। অন্যথায় এটি অ্যাকাউন্টে ডিফল্ট রাউট ব্যবহার করে। false
origin string যে উৎসের উপর ভিত্তি করে নির্বাচন করা হয়েছে। সম্ভাব্য মানগুলি হল: SCORE, CUSTOM_GLOBAL_COUNTRY, CUSTOM_GLOBAL_MCCMNC, CUSTOM_GLOBAL_PREFIX, CUSTOM_USER_COUNTRY, CUSTOM_USER_MCCMNC, CUSTOM_USER_PREFIX, MNP_FALLBACK, PLATFORM_DEFAULT, USER_DEFAULT false
prefixes array আপনার অ্যাকাউন্টে কনফিগার করা কাস্টম প্রিফিক্স-ভিত্তিক রাউটিং নিয়মের একটি তালিকা, যদি থাকে। false
countrycode string(2) একটি দুই অক্ষরের ISO দেশ কোড, যা প্রিফিক্সের দেশ চিহ্নিত করে। false
cns string যে প্রিফিক্সে রাউটিং নিয়ম প্রযোজ্য। false
route string(3) প্রিফিক্সের জন্য নির্বাচিত রাউট। false
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের MCCMNC (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড সমন্বয়) যা মোবাইল নেটওয়ার্ক অপারেটরকে শনাক্ত করে। true
mno string ভোক্তা-মুখী ব্র্যান্ড যার অধীনে এই নেটওয়ার্ক পরিচালিত হয়। true
countries array আপনার অ্যাকাউন্টে কনফিগার করা কাস্টম দেশ-ভিত্তিক নিয়মের একটি তালিকা, যদি থাকে। false
countrycode string(2) একটি দুই অক্ষরের ISO দেশ কোড, যা দেশ চিহ্নিত করে। false
route string(3) দেশের জন্য নির্বাচিত রাউট। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/hlr-coverage সুরক্ষিত

ডেটা-চালিত সিদ্ধান্ত গ্রহণে সহায়তা করার জন্য HLR কভারেজ সংক্রান্ত তথ্য প্রদান করে। এই এন্ডপয়েন্ট আপনাকে মোবাইল নেটওয়ার্কগুলিতে রিয়েল-টাইম HLR রাউটিং বিকল্পগুলি বিশ্লেষণ করতে, আপনার লক্ষ্য অঞ্চলগুলির জন্য সবচেয়ে কার্যকর পথ চিহ্নিত করতে এবং আপনার স্বয়ংক্রিয় রাউটিং কনফিগার করতে সহায়তা করে।

GET /route থেকে প্রস্তাবিত রুটগুলি এখানে প্রাপ্ত কভারেজ ডেটার উপর ভিত্তি করে তৈরি। কভারেজ ডেটা নেটওয়ার্ক কভারেজ পৃষ্ঠায়ও উপলব্ধ। আপনি আপনার অ্যাকাউন্ট সেটিংস-এ আপনার রাউটিং ম্যাপ আরও কাস্টমাইজ করতে এবং নিয়ম নির্ধারণ করতে পারেন।

ফলাফল ব্যাখ্যা করতে সহায়তার জন্য আমরা এই গাইড-এর সাথে পরিচিত হওয়ার পরামর্শ দিই।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স স্ট্যাটাস রেফারেন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/hlr-coverage?countrycode=XX'

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
countrycode string(2) একটি বাধ্যতামূলক দুই-অক্ষরের ISO দেশ কোড যা ফলাফল ফিল্টার করতে ব্যবহৃত হয়, শুধুমাত্র নির্দিষ্ট দেশের সাথে সম্পর্কিত রেকর্ড প্রদান করে। null বাধ্যতামূলক
sample_size string একটি ঐচ্ছিক প্যারামিটার যা নমুনা আকার নির্দিষ্ট করে। সম্ভাব্য মানগুলি হল LARGE, MEDIUM, SMALL। বড় নমুনা দীর্ঘ সময়সীমা কভার করে, ছোট নমুনা খুব সাম্প্রতিক সময়সীমা কভার করে। LARGE ঐচ্ছিক
200 OK 
{
   "name":"Germany",
   "countrycode":"DE",
   "prefix":"+49",
   "mccs":[
      "262"
   ],
   "carriers":[
      {
         "mno":"Telekom",
         "mccmnc":"26201",
         "mcc":"262",
         "mnc":"01 ",
         "routes":[
            {
               "route":"V11",
               "selected":true,
               "selection_confidence":"HIGH",
               "n":361579,
               "CONNECTED":275273,
               "CONNECTED_PCT":76.13,
               "ABSENT":21529,
               "ABSENT_PCT":5.95,
               "INVALID_MSISDN":62582,
               "INVALID_MSISDN_PCT":17.3,
               "UNDETERMINED":2195,
               "UNDETERMINED_PCT":0.6
            },
            {
               "route":"E10",
               "selected":false,
               "selection_confidence":null,
               "n":122600,
               "CONNECTED":13721,
               "CONNECTED_PCT":11.19,
               "ABSENT":133,
               "ABSENT_PCT":0.1,
               "INVALID_MSISDN":55,
               "INVALID_MSISDN_PCT":0.04,
               "UNDETERMINED":108691,
               "UNDETERMINED_PCT":88.65
            }
         ]
      }
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
name string নির্বাচিত দেশের নাম ইংরেজি সাধারণ টেক্সটে। false
countrycode string(2) নির্বাচিত দেশের দুই-অক্ষরের ISO দেশ কোড। false
prefix string নির্বাচিত দেশের আন্তর্জাতিক ডায়ালিং প্রিফিক্স। false
mccs string[] নির্বাচিত দেশের সাথে সম্পর্কিত MCC (মোবাইল কান্ট্রি কোড) এর তালিকা। false
carriers object[] রুট-নির্দিষ্ট কানেক্টিভিটি মেট্রিক্স সহ ক্যারিয়ার অবজেক্টের তালিকা। false
mno string মোবাইল নেটওয়ার্ক অপারেটরের নাম ইংরেজি সাধারণ টেক্সটে। false
mccmnc string মোবাইল নেটওয়ার্ক অপারেটরের MCCMNC। false
mcc string মোবাইল নেটওয়ার্ক অপারেটরের MCC (মোবাইল কান্ট্রি কোড)। false
mnc string মোবাইল নেটওয়ার্ক অপারেটরের MNC (মোবাইল নেটওয়ার্ক কোড)। false
routes object[] রুট-নির্দিষ্ট কানেক্টিভিটি ফলাফলের তালিকা। false
route string যে রুটের জন্য কানেক্টিভিটি তথ্য প্রযোজ্য। false
selected bool স্বয়ংক্রিয় রাউটিংয়ের জন্য এটি নির্বাচিত রুট কিনা তা নির্দেশ করে। false
selection_confidence string যে আত্মবিশ্বাসের স্তরে এই রুট নির্বাচিত হয়েছিল, অর্থাৎ LOW, NORMAL, HIGH, MNP_FALLBACK। এটি নির্বাচিত রুট না হলে null ধারণ করে। true
n int এই নমুনায় মোট লুকআপের সংখ্যা। false
CONNECTED int যে HLR লুকআপগুলি CONNECTED স্ট্যাটাস ফেরত দিয়েছে তার সংখ্যা। false
CONNECTED_PCT float যে HLR লুকআপগুলি CONNECTED স্ট্যাটাস ফেরত দিয়েছে তার শতাংশ। false
ABSENT int যে HLR লুকআপগুলি ABSENT স্ট্যাটাস ফেরত দিয়েছে তার সংখ্যা। false
ABSENT_PCT float যে HLR লুকআপগুলি ABSENT স্ট্যাটাস ফেরত দিয়েছে তার শতাংশ। false
INVALID_MSISDN int যে HLR লুকআপগুলি INVALID_MSISDN স্ট্যাটাস ফেরত দিয়েছে তার সংখ্যা। false
INVALID_MSISDN_PCT float যে HLR লুকআপগুলি INVALID_MSISDN স্ট্যাটাস ফেরত দিয়েছে তার শতাংশ। false
UNDETERMINED int যে HLR লুকআপগুলি UNDETERMINED স্ট্যাটাস ফেরত দিয়েছে তার সংখ্যা। false
UNDETERMINED_PCT float যে HLR লুকআপগুলি UNDETERMINED স্ট্যাটাস ফেরত দিয়েছে তার শতাংশ। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
স্ট্যাটাস বিবরণ
CONNECTED নম্বরটি বৈধ এবং লক্ষ্য হ্যান্ডসেটটি বর্তমানে মোবাইল নেটওয়ার্কের সাথে সংযুক্ত রয়েছে। কল, এসএমএস এবং অন্যান্য সেবা সফলভাবে প্রাপকের কাছে পৌঁছানো উচিত।
ABSENT নম্বরটি বৈধ, কিন্তু লক্ষ্য হ্যান্ডসেটটি হয় বন্ধ রয়েছে অথবা সাময়িকভাবে নেটওয়ার্ক কভারেজের বাইরে রয়েছে। ডিভাইসটি নেটওয়ার্কের সাথে পুনরায় সংযুক্ত না হওয়া পর্যন্ত বার্তা বা কল সরবরাহ নাও হতে পারে।
INVALID_MSISDN নম্বরটি অবৈধ বা বর্তমানে মোবাইল নেটওয়ার্কে কোনো গ্রাহকের জন্য বরাদ্দ নেই। এই নম্বরে কল এবং বার্তা ব্যর্থ হবে।
UNDETERMINED নম্বরটির সংযোগ স্থিতি নির্ধারণ করা যায়নি। এটি একটি অবৈধ নম্বর, SS7 ত্রুটি প্রতিক্রিয়া, অথবা লক্ষ্য নেটওয়ার্ক অপারেটরের সাথে সংযোগের অভাবের কারণে হতে পারে। অতিরিক্ত নির্ণয়ের জন্য ত্রুটি কোড এবং এর বিবরণ ক্ষেত্র পরীক্ষা করুন।
উপরে স্ক্রল করুন

GET/mnp-coverageসুরক্ষিত

এই এন্ডপয়েন্ট মোবাইল নেটওয়ার্ক অপারেটরদের একটি তালিকা প্রদান করে, তাদের সংশ্লিষ্ট MCCMNC শনাক্তকারী সহ, যা বর্তমানে মোবাইল নম্বর পোর্টেবিলিটি লুকআপের জন্য সমর্থিত।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/mnp-coverage?countrycode=XX'

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
countrycode string(2) একটি ঐচ্ছিক দুই-অক্ষরের ISO দেশ কোড যা MCCMNC ফলাফল ফিল্টার করতে ব্যবহৃত হয়, শুধুমাত্র নির্দিষ্ট দেশের সাথে প্রাসঙ্গিক ডেটা প্রদান করে। null ঐচ্ছিক
200 OK 
{
   "items":[
      {
         "country_name":"Germany",
         "country_code":"DE",
         "mccmnc":"26201",
         "mcc":"262",
         "mnc":"01 ",
         "brand":"Telekom",
         "operator":"Telekom Deutschland GmbH"
      },
      {
         "country_name":"Germany",
         "country_code":"DE",
         "mccmnc":"26202",
         "mcc":"262",
         "mnc":"02 ",
         "brand":"Vodafone",
         "operator":"Vodafone D2 GmbH"
      }
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
items[] array মোবাইল নেটওয়ার্ক অপারেটরদের একটি তালিকা। false
country_name string ইংরেজিতে দেশের নাম। false
country_code string(2) একটি দুই-অক্ষরের ISO দেশ কোড। false
mccmnc string(5|6) একটি পাঁচ বা ছয় অক্ষরের MCCMNC (মোবাইল কান্ট্রি কোড এবং মোবাইল নেটওয়ার্ক কোড সমন্বয়) যা মোবাইল নেটওয়ার্ক অপারেটরকে শনাক্ত করে। false
mcc string(3) একটি তিন-অক্ষরের MCC (মোবাইল কান্ট্রি কোড) যা নেটওয়ার্কের দেশ প্রতিনিধিত্ব করে। false
mnc string(2|3) একটি দুই বা তিন-অক্ষরের MNC (মোবাইল নেটওয়ার্ক কোড) যা নির্দিষ্ট মোবাইল নেটওয়ার্ক অপারেটরকে প্রতিনিধিত্ব করে। false
brand string ভোক্তা-মুখী ব্র্যান্ড যার অধীনে এই নেটওয়ার্ক পরিচালিত হয়। true
operator string মোবাইল নেটওয়ার্ক অপারেটরের আইনি নাম। true
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/price-listসুরক্ষিত

এই এন্ডপয়েন্ট এমন দেশগুলির তালিকা প্রদান করে যেখানে শুধুমাত্র MNP লুকআপ সমর্থিত, এবং এই গন্তব্যগুলির জন্য HLR কোয়েরি উপলব্ধ নেই।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/mnp-countries'
200 OK 
{
   "countries":[
      "AG",
      "AI",
      "AR",
      "AS",
      "AW",
      "BB",
      "BM",
      ...
      "US",
      "UY",
      "VC",
      "VE",
      "VG",
      "VN"
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
countries string[] দুই-অক্ষরের ISO দেশ কোডের তালিকা। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/mccmncsসুরক্ষিত

এই এন্ডপয়েন্টটি মোবাইল নেটওয়ার্ক অপারেটরদের একটি সম্পূর্ণ তালিকা প্রদান করে যাতে তাদের সংশ্লিষ্ট MCCMNC শনাক্তকারী এবং অতিরিক্ত প্রাসঙ্গিক তথ্য অন্তর্ভুক্ত থাকে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/mccmncs?countrycode=XX'

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
countrycode string(2) একটি ঐচ্ছিক দুই-অক্ষরের ISO দেশ কোড যা MCCMNC ফলাফল ফিল্টার করতে ব্যবহৃত হয়, শুধুমাত্র নির্দিষ্ট দেশের সাথে সম্পর্কিত রেকর্ড প্রদান করে। null ঐচ্ছিক
200 OK 
{
   "items":[
      {
         "country_name":"Germany",
         "country_code":"DE",
         "mccmnc":"26201",
         "mcc":"262",
         "mnc":"01 ",
         "brand":"Telekom",
         "operator":"Telekom Deutschland GmbH"
      },
      {
         "country_name":"Germany",
         "country_code":"DE",
         "mccmnc":"26202",
         "mcc":"262",
         "mnc":"02 ",
         "brand":"Vodafone",
         "operator":"Vodafone D2 GmbH"
      }
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
items object[] মোবাইল নেটওয়ার্ক অপারেটরদের একটি তালিকা। false
country_name string ইংরেজিতে সম্পূর্ণ দেশের নাম। false
country_code string(2) মোবাইল অপারেটরের দেশ নির্দেশক দুই-অক্ষরের ISO দেশ কোড। false
mccmnc string(5|6) একটি পাঁচ বা ছয়-অক্ষরের স্ট্রিং যা MCCMNC প্রতিনিধিত্ব করে, যা মোবাইল নেটওয়ার্ক অপারেটরকে অনন্যভাবে শনাক্ত করে। false
mcc string(3) একটি তিন-অক্ষরের মোবাইল কান্ট্রি কোড (MCC) যা মোবাইল নেটওয়ার্ক যে দেশে পরিচালিত হয় তা শনাক্ত করে। false
mnc string(2|3) একটি দুই বা তিন-অক্ষরের মোবাইল নেটওয়ার্ক কোড (MNC) যা প্রদত্ত MCC-এর মধ্যে মোবাইল নেটওয়ার্ক নির্দিষ্ট করে। false
brand string বাণিজ্যিক ব্র্যান্ড নাম যার অধীনে নেটওয়ার্ক পরিচালিত হয় এবং ভোক্তাদের দ্বারা স্বীকৃত। true
operator string মোবাইল নেটওয়ার্ক অপারেটরের সরকারি নাম, সাধারণত নেটওয়ার্ক পরিচালনাকারী আইনি সত্তা। true
parent_mccmnc string(5|6) একটি পাঁচ বা ছয়-অক্ষরের স্ট্রিং যা প্যারেন্ট মোবাইল নেটওয়ার্ক অপারেটরের MCCMNC প্রতিনিধিত্ব করে, যদি থাকে। true
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/priceসুরক্ষিত

এই এন্ডপয়েন্ট HLR, MNP বা NT লুকআপের মূল্য প্রদান করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/price?msisdn=+491788735000&route_type=HLR'

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

কী টাইপ বিবরণ ডিফল্ট বাধ্যতামূলক
msisdn string যে ফোন নম্বরের জন্য মূল্য পুনরুদ্ধার করতে হবে। আন্তর্জাতিক ফরম্যাটে। null বাধ্যতামূলক
route_type string রুট টাইপ, অর্থাৎ HLR, MNP, NT। null বাধ্যতামূলক
route string(3) যে রুটের জন্য মূল্য গণনা করা হবে। স্বয়ংক্রিয় রাউটিং দ্বারা নির্ধারিত রুট ডিফল্ট হিসেবে ব্যবহৃত হয়। null ঐচ্ছিক
200 OK 
{
   "price":{
      "amount":"0.01000",
      "msisdn":"+491788735000",
      "route_type":"HLR",
      "route":"DV8"
   }
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
price object মূল্য নির্ধারণের বিস্তারিত সহ একটি অবজেক্ট। false
amount string EUR-এ পরিমাণ। false
msisdn string যে MSISDN-এর জন্য এই মূল্য প্রযোজ্য। false
route_type string(2|3) যে রুট টাইপের জন্য এই মূল্য প্রযোজ্য। false
route string(3) যে রুটের জন্য এই মূল্য প্রযোজ্য। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/price-listসুরক্ষিত

এই এন্ডপয়েন্ট আপনার অ্যাকাউন্টের মূল্য তালিকা প্রদান করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/price-list'
200 OK 
{
   "pricing":[
      {
         "route":"V11",
         "countrycode":null,
         "countryname":null,
         "mccmnc":null,
         "cns":null,
         "route_type":"HLR",
         "price":"0.0090"
      },
      {
         "route":"V11",
         "countrycode":"DE",
         "countryname":"Germany",
         "mccmnc":"26201",
         "cns":null,
         "route_type":"HLR",
         "price":"0.0070"
      },
      {
         "route":"V11",
         "countrycode":"DE",
         "countryname":"Germany",
         "mccmnc":"26203",
         "cns":"4917821",
         "route_type":"HLR",
         "price":"0.0070"
      },
      {
         "route":"V11",
         "countrycode":"DE",
         "countryname":"Germany",
         "mccmnc":null,
         "cns":null,
         "route_type":"HLR",
         "price":"0.0070"
      },
      {
         "route":"PTX",
         "countrycode":null,
         "countryname":null,
         "mccmnc":null,
         "cns":null,
         "route_type":"MNP",
         "price":"0.00500"
      },
      ...
      {
         "route":"IP1",
         "countrycode":null,
         "countryname":null,
         "mccmnc":null,
         "cns":null,
         "route_type":"MIX",
         "price":"0.01000"
      },
      {
         "route":"LC1",
         "countrycode":null,
         "countryname":null,
         "mccmnc":null,
         "cns":null,
         "route_type":"NT",
         "price":"0.00500"
      }
   ]
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
pricing object[] মূল্য তথ্য সহ অবজেক্টের তালিকা। false
route string রুট যেটিতে এই মূল্য প্রযোজ্য। false
countrycode string দুই-অক্ষরের ISO দেশের কোড যেটিতে সংশ্লিষ্ট রুটের জন্য এই মূল্য প্রযোজ্য, যদি থাকে। true
countryname string দেশের কোডের সাথে সম্পর্কিত ইংরেজি দেশের নাম, যদি থাকে। true
mccmnc string MCCMNC যেটিতে সংশ্লিষ্ট রুটের জন্য এই মূল্য প্রযোজ্য, যদি থাকে। দেশ-স্তরের মূল্য ওভাররাইড করে। true
cns string ডায়ালিং প্রিফিক্স যেটিতে সংশ্লিষ্ট রুটের জন্য এই মূল্য প্রযোজ্য, যদি থাকে। দেশ-স্তরের মূল্য এবং MCCMNC-স্তরের মূল্য ওভাররাইড করে। true
route_type string সংশ্লিষ্ট রুট টাইপ, যেমন HLR, MNP, NT। false
route_type string EUR-এ সংশ্লিষ্ট মূল্য। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/balanceসুরক্ষিত

এই এন্ডপয়েন্ট আপনার বর্তমান অ্যাকাউন্ট ব্যালেন্স প্রদান করে, যা আপনার ক্রেডিট স্ট্যাটাসের ভিত্তিতে প্রক্রিয়াগুলি স্বয়ংক্রিয় করতে সাহায্য করে। এটি আপনার পেমেন্ট পেজে কনফিগার করা লো ক্রেডিট নোটিফিকেশন ইমেইলের সাথে নির্বিঘ্নে কাজ করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/balance'
200 OK 
{
    "balance":"1002.90"
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
balance string EUR-এ আপনার বর্তমান অ্যাকাউন্ট ব্যালেন্স। স্ট্রিং টাইপের একটি দশমিক মান। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/pingসর্বজনীন

এই এন্ডপয়েন্ট API-তে একটি পিং অনুরোধ পাঠায়, যা HLR Lookups API-এর সাথে আপনার সংযোগ পরীক্ষা করার জন্য একটি সহজ পদ্ধতি প্রদান করে।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/ping'
200 OK 
{
    "success":true
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
success boolean নির্দেশ করে যে অনুরোধটি সফলভাবে প্রক্রিয়া করা হয়েছে। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/timeসর্বজনীন

এই এন্ডপয়েন্টটি HLR Lookups সার্ভারের বর্তমান সময়ের প্রতিনিধিত্বকারী একটি Unix টাইমস্ট্যাম্প প্রদান করে। প্রমাণীকরণের জন্য Digest-Auth স্বাক্ষর তৈরি করার সময় আপনার সার্ভারের ঘড়ি সিঙ্ক্রোনাইজ করতে এটি ব্যবহার করুন, যাতে আপনার সার্ভার সময় এবং HLR Lookups সার্ভার সময়ের মধ্যে যেকোনো পার্থক্য সংশোধন করা হয়।

অনুরোধ সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/time'
200 OK 
{
    "time":1525898643
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
time integer বর্তমান HLR Lookups সার্ভার সময়ের প্রতিনিধিত্বকারী Unix টাইমস্ট্যাম্প। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

GET/auth-testসুরক্ষিত

এই এন্ডপয়েন্টটি আপনার Basic-Auth অথবা, বিশেষভাবে, Digest-Auth বাস্তবায়নের প্রাথমিক পরীক্ষা হিসেবে কাজ করে।

বেসিক অথ অনুরোধ ডাইজেস্ট অথ রিকোয়েস্ট সফল রেসপন্স ত্রুটি রেসপন্স
cURL 
curl 'https://www.hlr-lookups.com/api/v2/auth-test' \
  -H "X-Basic: YOUR_API_KEY"

অনুরোধ হেডার

কী টাইপ বিবরণ
X-Basic string YOUR_API_KEY:YOUR_API_SECRET-এর SHA256 হ্যাশ। হ্যাশে কোলন চিহ্ন (:) অন্তর্ভুক্ত করুন।
cURL (Digest-Auth) 
curl 'https://www.hlr-lookups.com/api/v2/auth-test' \
  -H "X-Digest-Key: YOUR_API_KEY" \
  -H "X-Digest-Signature: DIGEST_AUTH_SIGNATURE" \
  -H "X-Digest-Timestamp: UNIX_TIMESTAMP"

অনুরোধ হেডার

কী টাইপ বিবরণ
X-Digest-Key string আপনার HLR Lookups API কী
X-Digest-Signature string অনন্য ডাইজেস্ট-অথ স্বাক্ষর (দেখুন প্রমাণীকরণ)
X-Digest-Timestamp integer বর্তমান ইউনিক্স টাইমস্ট্যাম্প (আরও দেখুন GET /time)
200 OK 
{
    "success":true
}

সফল রেসপন্স অ্যাট্রিবিউট

নাম টাইপ বিবরণ নালযোগ্য
success boolean নির্দেশ করে যে অনুরোধটি সফলভাবে প্রক্রিয়া করা হয়েছে। false
4xx/5xx 
{
    "errors":[
        "Service unavailable."
    ]
}

ত্রুটি প্রতিক্রিয়া প্যারামিটার

নাম টাইপ বিবরণ নালযোগ্য
errors[] string[] ত্রুটি ব্যাখ্যাকারী স্ট্রিং এর তালিকা। false
উপরে স্ক্রল করুন

লিগ্যাসি API ডকুমেন্টেশন

অনুগ্রহ করে লক্ষ্য করুন যে লিগ্যাসি API অবচিত এবং ভবিষ্যতে এটি বন্ধ করার পরিকল্পনা রয়েছে। আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি যত শীঘ্র সম্ভব সর্বশেষ সংস্করণে আপগ্রেড করুন।

আপনি যদি ২০১৩ থেকে ২০২০ সালের প্রথম দিকের মধ্যে আমাদের HLR Lookups API ইমপ্লিমেন্ট করে থাকেন, তাহলে আপনি আমাদের লিগ্যাসি API ব্যবহার করছেন। সেক্ষেত্রে অনুগ্রহ করে আমাদের লিগ্যাসি API ডকুমেন্টেশন দেখুন।

লিগ্যাসি API ডকুমেন্টেশন

সেরা মানের HLR Lookups প্ল্যাটফর্মের মাধ্যমে আপনার মোবাইল ইন্টেলিজেন্স উন্নত করুন


যোগাযোগ করুন
ভাষাসমূহ한국어ภาษาไทยBahasa IndonesiaČeštinaDanskDeutschEestiEnglishEspañolFilipinoFrançaisItalianoLatviešuLietuviųMagyarNederlandsNorskPolskiPortuguêsRomânăSuomiSvenskaTiếng ViệtTürkçeΕλληνικάБългарскиРуccкийУкраїнськаहिन्दीবাংলা日本語简体中文繁体中文
© Velocity Made Good Ltd. 2013-2026 · সেবার শর্তাবলী · গোপনীয়তা নীতি · ডেটা প্রসেসিং চুক্তি
স্পিনিং লোডার স্বচ্ছ Gif