फ़ैक्स कार्य की स्थिति जाँचें

अपना कार्य खोजें

सक्षम MultiTEL API खाता उपयोग करें। पासवर्ड वाले खाते के लिए HTTP Basic क्रेडेंशियल भेजें, या टोकन वाले खाते के लिए Bearer टोकन भेजें। खाते की अनुमतियाँ और IP प्रतिबंध अब भी लागू हैं। आंतरिक वर्कर क्रेडेंशियल उपयोग न करें।

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id आवश्यक है और यह send_fax से मिला 32 अक्षरों वाला हेक्साडेसिमल पहचानकर्ता होना चाहिए। इसे हूबहू कॉपी करें। अनुरोध प्रमाणीकरण कर चुके स्वामी तक सीमित हैं।

परिणाम पढ़ें

HTTP परिणाम और JSON का status.code फ़ील्ड दोनों पढ़ें। JSON विफलताएँ HTTP 200 के साथ आ सकती हैं। सफल JSON उत्तर में status और response होते हैं; उदाहरण काल्पनिक डेटा का उपयोग करते हैं।

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

उदाहरण कतार में मौजूद कार्य का है, पहुँचाए गए फ़ैक्स या मूल्य प्रस्ताव का नहीं। pages_requested स्रोत के पहचाने गए पृष्ठों की संख्या है; pages_sent प्रोसेसिंग के दौरान दर्ज प्रगति बताता है। cost दशमलव संख्या वाली स्ट्रिंग है और कतार में रहते समय भी उसमें अनुमान हो सकता है। result प्रोसेसिंग का विवरण रखता है; webhook_status दर्ज की गई कॉलबैक स्थिति रखता है। टाइमस्टैम्प सर्वर द्वारा फ़ॉर्मैट की गई स्ट्रिंग हैं जिनमें समय क्षेत्र का ऑफ़सेट नहीं है।

लगातार तेज़ लूप के बजाय बढ़ते अंतराल पर स्थिति पूछें। प्रोसेसिंग भेजा गया या पूरा हुआ स्थिति बता सकती है, लेकिन मौजूदा ऑडिट ने प्राप्तकर्ता तक पहुँचने की गारंटी स्थापित नहीं की है। महत्वपूर्ण दस्तावेज़ को पहुँचा हुआ मानने या दोबारा भेजने से पहले प्राप्तकर्ता से दस्तावेज़ मिलने की पुष्टि करें। सक्रिय वर्कर का जीवनचक्र, अंतिम बिलिंग नियम और कॉलबैक अनुबंध अभी जाँचे जा रहे हैं। यह न मानें कि कतार में स्वीकृति या गैर-खाली कार्य ID का अर्थ पहुँच जाना है।

त्रुटियाँ

API कोड 400 का अर्थ job_id का गायब या गलत प्रारूप में होना है; 401 का अर्थ प्रमाणीकरण का गायब होना है; 404 का अर्थ इस खाते के लिए कार्य न मिलना है। केवल पहचानकर्ता से स्वामित्व का अनुमान न लगाएँ।