सक्रियताओं का इतिहास प्राप्त करना
getHistory विधि का उपयोग SMS.online API के माध्यम से आपके खाते से जुड़े वर्चुअल नंबरों की सभी सक्रियताओं के इतिहास को प्राप्त करने के लिए किया जाता है। यह सक्रियताओं के विश्लेषण और सेवाओं पर खर्च की निगरानी की प्रक्रिया को स्वचालित करने की अनुमति देता है।
यह विधि प्रत्येक सक्रियता के लिए विस्तृत जानकारी प्राप्त करने के लिए है, जिसमें तारीख, फोन नंबर, प्राप्त SMS कोड, लागत और वर्तमान स्थिति शामिल है। यह नंबरों के उपयोग को ट्रैक करना और खर्चों पर नियंत्रण करना आसान बनाता है।
सफल अनुरोध एक संरचित सक्रियताओं की सूची लौटाता है जिसमें विस्तृत डेटा होता है: सक्रियता की अद्वितीय पहचान, निर्माण की तारीख, फोन नंबर, प्राप्त SMS संदेशों की सूची, लागत (सक्रिय के लिए — 0) और सक्रियता की स्थिति। यह विधि विश्लेषणात्मक और सेवा खर्च प्रबंधन प्रणालियों के लिए उपयुक्त है।
अनुरोध का उदाहरण:
इनपुट डेटा
पैरामीटर | आवश्यक | नोट | विवरण |
---|---|---|---|
हाँ | API कुंजी में सेटिंग्स में प्रोफ़ाइल में देखें | API कुंजी भुगतान की गई सेवाओं तक पहुंच प्रदान करती है | |
हाँ | getHistory | विधि का नाम | |
नहीं | यूनिक्स टाइमस्टैम्प प्रारूप में समय चिह्न | किस तारीख से सक्रियताएँ लेनी हैं (30 दिनों तक सीमित) | |
नहीं | यूनिक्स टाइमस्टैम्प प्रारूप में समय चिह्न | किस तारीख तक सक्रियताएँ लेनी हैं (30 दिनों तक सीमित) | |
नहीं | संख्यात्मक मान | प्रतिक्रिया में लौटाए गए पहले तत्व का ऑफसेट (डिफ़ॉल्ट 0) | |
नहीं | संख्यात्मक मान | प्रतिक्रिया में लौटाए गए तत्वों की संख्या (डिफ़ॉल्ट 50, अधिकतम 100) |
सर्वर का उत्तर
[ { "id": 635468024, "date": "2022-11-12 15:58:39", "phone": "79918529716", "sms": "["Your sms code"]", "cost": 100 "status": "4" } ]
कोड का उदाहरण
const api_key = "API_KEY"; # 'API_KEY' को अपने वास्तविक API कुंजी से बदलें।try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getHistory`);# निर्दिष्ट URL पर GET अनुरोध करेंconst data = await response.json();# सर्वर से उत्तर की सामग्री प्रदर्शित करेंconsole.log(data);} catch (err) {# यदि कोई त्रुटि हुई, तो त्रुटि संदेश प्रदर्शित करेंconsole.error(err);}
संभावित त्रुटियाँ
पैरामीटर | विवरण |
---|---|
अमान्य क्रिया | |
गलत API कुंजी | |
अनुरोध में त्रुटि | |
समय जब खाता निलंबित है | |
खाता सक्रिय नहीं है | |
अमान्य तारीख |