বহির্গামী ফ্যাক্সের কাজগুলির তালিকা দেখুন

বহির্গামী ফ্যাক্সের কাজগুলির তালিকা দেখুন

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

এই হ্যান্ডলার date_from বা date_to ফিল্টার সমর্থন করে না। পোর্টালের বহির্গামী ফ্যাক্সের তালিকায় অতিরিক্ত ফিল্টার আছে, যেগুলি এই API অনুরোধে কপি করা উচিত নয়। ফলাফল তৈরির সময় অনুযায়ী সাজানো হয়, সর্বশেষটি আগে থাকে; দ্বিতীয় ধাপে ID অনুযায়ী সাজানো বা স্ন্যাপশট কার্সর ব্যবহার করা হয় না।

কাজের রেকর্ড পড়ুন

HTTP ফলাফল ও JSON-এর status.code দুটিই পড়ুন। সফল প্রতিক্রিয়ায় response.faxes ও response.pagination থাকে; উদাহরণে কাল্পনিক তথ্য ব্যবহার করা হয়েছে। মেইলবক্স খালি থাকলে একটি খালি faxes অ্যারে ফেরত আসে, যেখানে total 0 এবং total_pages 0 থাকে।

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id হলো রেকর্ডের সংখ্যাসূচক ID। uuid হলো কাজের দৃশ্যমান শনাক্তকারী; নতুন জমার জন্য send_fax থেকে ফেরত পাওয়া কাজের ID ব্যবহার করুন এবং এটি সংরক্ষণ করুন নিয়মিত স্থিতি যাচাইয়ের জন্য। তালিকায় পুরোনো রেকর্ডও থাকতে পারে, তাই প্রতিটি সারি একই জমা দেওয়ার এন্ডপয়েন্টের মাধ্যমে তৈরি হয়েছে বলে ধরে নেবেন না।

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

pages_requested এবং pages_sent হলো সংখ্যাসূচক গণনা। cost সংরক্ষিত মান বজায় রাখে এবং বিকল্প মান হিসেবে 0.00 স্ট্রিং ব্যবহার করে; এটির JSON ধরন আগত ফ্যাক্সের খরচের ধরনের মতোই হবে বলে ধরে নেবেন না। সারিতে থাকা রেকর্ডেও ইতিমধ্যে একটি আনুমানিক খরচ থাকতে পারে। সেই মান বা তালিকার কোনো রেকর্ড কোনোটিই চূড়ান্ত বিল নির্ধারণ করে না।

created_at, sent_at এবং updated_at হলো সার্ভারের বিন্যাসে সংরক্ষিত মান, যেগুলিতে সময় অঞ্চলের অফসেট নেই; sent_at-এর মান null হতে পারে। স্থিতি জানার পৃথক এন্ডপয়েন্টে ফেরত দেওয়া ওয়েবহুকের স্থিতির ফিল্ডটি এই তালিকায় থাকে না।

সতর্কভাবে বিভিন্ন পৃষ্ঠার রেকর্ড মিলিয়ে নিন

pagination.page, limit, total ও total_pages অনুসরণ করুন। শেষ পৃষ্ঠার পরের পৃষ্ঠাগুলি খালি হতে পারে। আপনি তালিকা দেখার সময় নতুন কাজ যোগ হলে রেকর্ড এক পৃষ্ঠা থেকে অন্য পৃষ্ঠায় সরে যেতে পারে। বিভিন্ন পৃষ্ঠার রেকর্ড একত্র করার সময় কাজের শনাক্তকারীগুলি রাখুন; এই এন্ডপয়েন্ট অপরিবর্তিত স্ন্যাপশটের নিশ্চয়তা দেয় না।

গোপনীয়তা ও পুনরায় চেষ্টা

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