किराए की स्थिति बदलें
setRentStatus विधि का उपयोग SMS.online API के माध्यम से किराए पर लिए गए वर्चुअल नंबर की वर्तमान स्थिति को बदलने के लिए किया जाता है। यह विधि किराए की स्थिति को स्वचालित रूप से प्रबंधित करने की अनुमति देती है, जिसमें नंबर का उपयोग समाप्त करना, किराए की अवधि बढ़ाना या उसे मुक्त करना शामिल है।
यह विधि उन सिस्टम के लिए है जो वास्तविक समय में किराए पर लिए गए नंबरों की स्थिति पर त्वरित नियंत्रण की आवश्यकता होती है। इसके माध्यम से आप किराए के समाप्ति, विस्तार या अन्य स्थिति परिवर्तनों को निर्दिष्ट कर सकते हैं, जिससे जानकारी अद्यतित रहती है।
सफल अनुरोध एक ऑब्जेक्ट लौटाता है जिसमें किराए की स्थिति के परिवर्तन की पुष्टि होती है, जिसमें अपडेटेड किराए के पैरामीटर शामिल होते हैं। यह विधि उन सेवाओं में विशेष रूप से उपयोगी है जहां किराए पर लिए गए नंबरों के उपयोग की जानकारी को तेजी से अपडेट करने की आवश्यकता होती है।
अनुरोध का उदाहरण:
इनपुट डेटा
पैरामीटर | आवश्यक | नोट | विवरण |
---|---|---|---|
हाँ | API कुंजी में सेटिंग्स में प्रोफ़ाइल में देखें | API कुंजी भुगतान की गई सेवाओं तक पहुंच प्रदान करती है | |
हाँ | setRentStatus | विधि का नाम | |
हाँ | संख्यात्मक मान | सक्रियता ID, जो नंबर के अनुरोध पर प्राप्त किया गया | |
हाँ | संख्यात्मक मान | किराए की स्थिति |
स्थिति निम्नलिखित मान ले सकती है:
1 - नंबर के साथ काम समाप्त करें
2 - खरीद रद्द करें
सर्वर का उत्तर
{ "status": "success" }
कोड का उदाहरण
const api_key = "API_KEY"; # 'API_KEY' को अपने वास्तविक API कुंजी से बदलें।const id = 1; # नंबर के अनुरोध पर प्राप्त सक्रियता ID डालेंconst status = 1; # ऊपर की तालिका से नया स्थिति डालेंtry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setRentStatus&id=${id}&status=${status}`);# निर्दिष्ट URL पर GET अनुरोध करेंconst data = await response.json();# सर्वर से उत्तर की सामग्री प्रदर्शित करेंconsole.log(data);} catch (err) {# यदि कोई त्रुटि हुई, तो त्रुटि संदेश प्रदर्शित करेंconsole.error(err);}
संभावित त्रुटियाँ
पैरामीटर | विवरण |
---|---|
अमान्य क्रिया | |
गलत API कुंजी | |
अनुरोध में त्रुटि | |
समय जब खाता निलंबित है | |
खाता सक्रिय नहीं है | |
किराए का ID निर्दिष्ट नहीं किया गया | |
नंबर आपके द्वारा किराए पर नहीं लिया गया (गलत किराए का ID) | |
स्थिति अनुपस्थित है या गलत तरीके से निर्दिष्ट है | |
किराया रद्द नहीं किया जा सकता (20 मिनट से अधिक) | |
किराया पहले से ही समाप्त हो चुका है | |
किराया पहले से ही रद्द किया जा चुका है |