भेजे जाने वाले फ़ैक्स कार्यों की सूची देखें

भेजे जाने वाले फ़ैक्स कार्यों की सूची देखें

सक्रिय MultiTEL API खाते का उपयोग HTTPS के माध्यम से करें और उसके लिए निर्धारित प्रमाणीकरण विवरण तथा IP प्रतिबंधों का पालन करें। यह एंडपॉइंट प्रमाणित खाते से संबंधित भेजे जाने वाले फ़ैक्स के रिकॉर्ड की सूची देता है। सूची देखने से कोई फ़ैक्स भेजा या दोबारा भेजा नहीं जाता।

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 अनुरोध में कॉपी नहीं करना चाहिए। परिणाम बनाए जाने के समय के क्रम में, सबसे नए पहले, दिए जाते हैं; समान समय वाले रिकॉर्ड के लिए पहचान संख्या के आधार पर कोई द्वितीयक क्रम नहीं होता और न ही स्नैपशॉट कर्सर होता है।

कार्य के रिकॉर्ड पढ़ें

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 रिकॉर्ड की संख्यात्मक पहचान है। uuid कार्य की दिखाई देने वाली पहचान है; नए अनुरोधों के लिए इस एंडपॉइंट से मिली कार्य पहचान का उपयोग करें: send_fax। इस पहचान को सहेजकर रखें ताकि आप स्थिति की नियमित जाँच कर सकें। सूची में पुराने रिकॉर्ड भी हो सकते हैं, इसलिए यह न मानें कि हर पंक्ति एक ही अनुरोध भेजने वाले एंडपॉइंट के माध्यम से बनाई गई थी।

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 के अनुसार पृष्ठों को पढ़ें। अंतिम पृष्ठ से आगे के पृष्ठ खाली हो सकते हैं। आपके ब्राउज़ करते समय नए कार्य जुड़ने से प्रविष्टियाँ एक पृष्ठ से दूसरे पृष्ठ पर जा सकती हैं। पृष्ठों को मिलाते समय कार्य की पहचानें सहेजकर रखें; यह एंडपॉइंट एक स्थिर स्नैपशॉट की गारंटी नहीं देता।

गोपनीयता और दोबारा प्रयास

आउटबॉक्स के रिकॉर्ड में निजी टेलीफ़ोन मेटाडेटा होता है। इन्हें पढ़ने की अनुमति सीमित लोगों को दें और पूरे उत्तर लॉग में दर्ज करने से बचें। सूची में किसी प्रविष्टि का न होना यह सिद्ध नहीं करता कि भेजने का अनुरोध विफल हो गया था: दोबारा अनुरोध भेजने से पहले सहेजी गई कार्य पहचान और पोर्टल का आउटबॉक्स जाँचें। नया भेजने का अनुरोध एक और फ़ैक्स बना सकता है, जिसके लिए शुल्क लग सकता है। पृष्ठभूमि प्रक्रिया, बिलिंग, कॉलबैक और डेटा को सहेजे रखने से जुड़ी अंतिम गारंटियों की समीक्षा अभी जारी है।