मुख्य सामग्री पर जाएं
Wbiztool

WhatsApp अकाउंट API

कनेक्टेड WhatsApp नंबरों की सूची API

अपने वर्कस्पेस के वे WhatsApp नंबर पाएं जो अभी कनेक्टेड हैं। इसका इस्तेमाल यूज़र्स को यह चुनने देने के लिए करें कि किस नंबर से भेजना है, या दूसरे API कॉल के लिए whatsapp_client ID ढूंढने के लिए।

POSThttps://wbiztool.com/api/v1/whatsapp-client/list/

बॉडी: JSON या फॉर्म फील्ड

केवल कनेक्टेड नंबर लौटाए जाते हैं। डिसकनेक्ट हुए नंबर भी देखने के लिए अकाउंट की सूची इस्तेमाल करें।

छोटा उदाहरण#

curl -X POST https://wbiztool.com/api/v1/whatsapp-client/list/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

12345 और YOUR_API_KEY की जगह अपनी वैल्यू डालें। ये कहां मिलेंगी, यह जानने के लिए ऑथेंटिकेशन देखें।

रिक्वेस्ट पैरामीटर#

client_idintegerआवश्यक

सेटिंग्स → API Keys से आपका API क्लाइंट ID।

api_keystringआवश्यक

उसी पेज से आपकी API की। सूची उसी वर्कस्पेस की होती है जिसमें यह की बनाई गई थी।

आधिकारिक क्लाइंट का इस्तेमाल#

Python क्लाइंट आपके लिए यह एंडपॉइंट कॉल करता है।

Python
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.list_whatsapp_clients()
for number in result.get("whatsapp_clients", []):
    print(number["whatsapp_client_id"], number["whatsapp_client_number"])

जब API HTTP 400 या 403 लौटाता है, तो Python क्लाइंट requests.exceptions.HTTPError रेज़ करता है, इसलिए कॉल को try/except में रखें।

Node.js क्लाइंट का getWhatsAppClients() ऐसे पते को कॉल करता है जो मौजूद नहीं है और 404 के साथ फेल हो जाता है। छोटा उदाहरण की तरह fetch इस्तेमाल करें।

रिस्पॉन्स#

सफल रिक्वेस्ट HTTP 200 लौटाती है:

{
  "message": "okay",
  "whatsapp_clients": [
    {
      "id": 678,
      "whatsapp_client_id": 678,
      "whatsapp_client_number": "919876543210",
      "is_connected": true
    }
  ],
  "status": 1
}
फील्डटाइपविवरण
statusintegerसफल होने पर 1, रिक्वेस्ट फेल होने पर 0
messagestringसफल होने पर okay, वरना एरर।
whatsapp_clientsarrayआपके कनेक्टेड नंबर। कोई भी कनेक्टेड न हो तो खाली। केवल सफल होने पर मौजूद होता है।
whatsapp_clients[].whatsapp_client_idintegerनंबर का ID। दूसरे API कॉल में इसे whatsapp_client के रूप में पास करें।
whatsapp_clients[].idintegerwhatsapp_client_id जैसी ही वैल्यू।
whatsapp_clients[].whatsapp_client_numberstringफोन नंबर, जैसा वह नंबर जोड़ते समय सेव हुआ था।
whatsapp_clients[].is_connectedbooleanहमेशा true, क्योंकि केवल कनेक्टेड नंबर ही सूची में आते हैं।

सूची किसी तय क्रम में नहीं आती। अगर क्रम मायने रखता है, तो whatsapp_client_id से सॉर्ट करें।

एरर#

संदेशHTTPकैसे ठीक करें
Auth Error200client_id और api_key दोनों को POST बॉडी में, सही JSON या फॉर्म फील्ड के रूप में भेजें।
Invalid Client Id403client_id को पूर्ण संख्या के रूप में भेजें, जैसे 12345
Auth Error: invalid api key400जांचें कि की मौजूद है, डिलीट नहीं हुई है और इसी client_id की है।

POST के अलावा कोई भी रिक्वेस्ट खाली ऑब्जेक्ट {} लौटाती है। सर्वर पर कोई अनपेक्षित समस्या होने पर HTML बॉडी के साथ HTTP 500 लौटता है, इसलिए status पढ़ने से पहले जांच लें कि रिस्पॉन्स JSON है।

सुझाव#

  • खाली सूची: "whatsapp_clients": [] का मतलब है कि इस वर्कस्पेस में कोई नंबर कनेक्टेड नहीं है। WhatsApp सेटिंग्स में या नंबर कनेक्ट करें से एक नंबर कनेक्ट करें।
  • कई वर्कस्पेस: API की से तय होता है कि किस वर्कस्पेस की सूची मिलेगी। उसी वर्कस्पेस में बनाई गई की इस्तेमाल करें जो आपको चाहिए।
  • सिर्फ एक नंबर: किसी एक नंबर को जांचने के लिए कनेक्शन स्टेटस इस्तेमाल करें।