প্রাপ্ত ফ্যাক্সের তালিকা দেখুন

প্রাপ্ত ফ্যাক্সের তালিকা দেখুন

সক্রিয় MultiTEL API অ্যাকাউন্টের কনফিগার করা প্রমাণীকরণ তথ্য ও আইপি বিধিনিষেধ মেনে HTTPS দিয়ে সেটি ব্যবহার করুন। এই এন্ডপয়েন্ট প্রমাণীকৃত অ্যাকাউন্টের প্রাপ্ত ফ্যাক্সগুলোর তালিকা দেখায়। এটি ফ্যাক্স পাঠায় না বা তার নথি ডাউনলোড করে না।

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

তারিখের সীমার দুই প্রান্তই অন্তর্ভুক্ত হয় এবং তারিখ নির্ধারণে API সার্ভারের ব্যাখ্যা ব্যবহৃত হয়, অনুরোধ করা ব্যবহারকারীর সময় অঞ্চল নয়। অবৈধ তারিখের স্ট্রিং প্রত্যাখ্যান না করে উপেক্ষা করা হতে পারে; পাঠানোর আগে সেগুলো যাচাই করুন। তারিখের ফিল্টার না থাকলে হ্যান্ডলার কোনো পূর্বনির্ধারিত তারিখের পরিসর আরোপ করে না। ফলাফল প্রাপ্তির সময় অনুযায়ী সাজানো হয়, সবচেয়ে নতুনটি আগে থাকে। এন্ডপয়েন্টটি সব পৃষ্ঠা জুড়ে একই স্থির অবস্থার চিত্র দেয় না: নতুন ফ্যাক্স এলে রেকর্ড এক পৃষ্ঠা থেকে অন্য পৃষ্ঠায় সরে যেতে পারে।

মেইলবক্সের পৃষ্ঠা পড়ুন

HTTP ফলাফল ও JSON-এর status.code পড়ুন। API-এর অন্য কোথাও ব্যর্থতা ঘটলে JSON ত্রুটি-মোড়ক ব্যবহার করা হতে পারে, এমনকি HTTP স্ট্যাটাস 200 হলেও। সফল প্রতিক্রিয়ায় response.faxes ও response.pagination থাকে। এই উদাহরণে কাল্পনিক মান ব্যবহার করা হয়েছে।

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id হলো ইনবক্স রেকর্ডের সংখ্যাসূচক শনাক্তকারী। hash হলো পুরোনো আগত নথির কার্যপ্রবাহে ব্যবহারের জন্য এর MD5 রূপ; এটি send_fax কাজের শনাক্তকারী বা অনুমোদনের প্রমাণীকরণ তথ্য নয়। বহির্গামী ফ্যাক্সের fax_status এন্ডপয়েন্টের সঙ্গে এটি ব্যবহার করবেন না।

received_timestamp হলো সংরক্ষিত ইউনিক্স টাইমস্ট্যাম্প। received_at হলো সার্ভারের বিন্যাসে দেওয়া টাইমস্ট্যাম্প, যাতে সময় অঞ্চলের অফসেট থাকে না; প্রাপ্তির সময় রেকর্ড করা না থাকলে এর মান null হয়। নিজের সময় অঞ্চলে সময় দেখানোর সময় ইউনিক্স মানটি ব্যবহার করুন। cost হলো একটি JSON সংখ্যা, দামের প্রস্তাব বা আলাদাভাবে সম্পন্ন অর্থ আদায়ের প্রমাণ নয়।

status কেবল সংরক্ষিত স্ট্যাটাস কোড শূন্য হলে success হয়; অন্য মানগুলোর ক্ষেত্রে failed হয়। status_text সংরক্ষিত প্রক্রিয়াকরণ বার্তা বহন করে; সেটি না থাকলে বিকল্প হিসেবে OK বা Failed ব্যবহৃত হয়। emailed বুলিয়ান মানের পরিবর্তে সংরক্ষিত মানটি অপরিবর্তিত রাখে। viewed হলো একটি বুলিয়ান মান। শুধু ফ্যাক্সের স্ট্যাটাস থেকে ইমেইল সফলভাবে পৌঁছেছে বলে ধরে নেবেন না।

খালি ও পরিবর্তনশীল তালিকা সামলান

মেইলবক্স খালি হলে একটি খালি faxes অ্যারে, total 0 এবং total_pages 0 ফেরত আসে। শেষ পৃষ্ঠার পরের কোনো পৃষ্ঠার জন্যও খালি অ্যারে ফেরত আসতে পারে। অন্তত একটি পৃষ্ঠা আছে ধরে না নিয়ে পৃষ্ঠা বিভাজনের ফিল্ড অনুযায়ী থামুন। কোনো কার্সর বা রেকর্ড শনাক্তকারী অনুযায়ী গৌণ সাজানোর ব্যবস্থা উন্মুক্ত করা হয়নি। একই রেকর্ড থাকা পৃষ্ঠাগুলো মিলিয়ে নেওয়ার সময় রেকর্ডের শনাক্তকারীগুলো সংরক্ষণ করুন।

নথিতে প্রবেশাধিকার ও গোপনীয়তা

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