WhatsApp अकाउंट API
कनेक्टेड WhatsApp नंबरों की सूची API
अपने वर्कस्पेस के वे WhatsApp नंबर पाएं जो अभी कनेक्टेड हैं। इसका इस्तेमाल यूज़र्स को यह चुनने देने के लिए करें कि किस नंबर से भेजना है, या दूसरे API कॉल के लिए whatsapp_client ID ढूंढने के लिए।
https://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"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp-client/list/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result.get("status") == 1:
for number in result["whatsapp_clients"]:
print(number["whatsapp_client_id"], number["whatsapp_client_number"])
else:
print("Failed:", result.get("message"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp-client/list/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
for (const number of result.whatsapp_clients) {
console.log(number.whatsapp_client_id, number.whatsapp_client_number);
}
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/list/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($result['status'] ?? 0) === 1) {
foreach ($result['whatsapp_clients'] as $number) {
echo $number['whatsapp_client_id'] . ' ' . $number['whatsapp_client_number'] . PHP_EOL;
}
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}12345 और YOUR_API_KEY की जगह अपनी वैल्यू डालें। ये कहां मिलेंगी, यह जानने के लिए ऑथेंटिकेशन देखें।
रिक्वेस्ट पैरामीटर#
client_idintegerआवश्यकसेटिंग्स → API Keys से आपका API क्लाइंट ID।
api_keystringआवश्यकउसी पेज से आपकी API की। सूची उसी वर्कस्पेस की होती है जिसमें यह की बनाई गई थी।
आधिकारिक क्लाइंट का इस्तेमाल#
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
}
| फील्ड | टाइप | विवरण |
|---|---|---|
status | integer | सफल होने पर 1, रिक्वेस्ट फेल होने पर 0। |
message | string | सफल होने पर okay, वरना एरर। |
whatsapp_clients | array | आपके कनेक्टेड नंबर। कोई भी कनेक्टेड न हो तो खाली। केवल सफल होने पर मौजूद होता है। |
whatsapp_clients[].whatsapp_client_id | integer | नंबर का ID। दूसरे API कॉल में इसे whatsapp_client के रूप में पास करें। |
whatsapp_clients[].id | integer | whatsapp_client_id जैसी ही वैल्यू। |
whatsapp_clients[].whatsapp_client_number | string | फोन नंबर, जैसा वह नंबर जोड़ते समय सेव हुआ था। |
whatsapp_clients[].is_connected | boolean | हमेशा true, क्योंकि केवल कनेक्टेड नंबर ही सूची में आते हैं। |
सूची किसी तय क्रम में नहीं आती। अगर क्रम मायने रखता है, तो whatsapp_client_id से सॉर्ट करें।
एरर#
| संदेश | HTTP | कैसे ठीक करें |
|---|---|---|
Auth Error | 200 | client_id और api_key दोनों को POST बॉडी में, सही JSON या फॉर्म फील्ड के रूप में भेजें। |
Invalid Client Id | 403 | client_id को पूर्ण संख्या के रूप में भेजें, जैसे 12345। |
Auth Error: invalid api key | 400 | जांचें कि की मौजूद है, डिलीट नहीं हुई है और इसी client_id की है। |
POST के अलावा कोई भी रिक्वेस्ट खाली ऑब्जेक्ट {} लौटाती है। सर्वर पर कोई अनपेक्षित समस्या होने पर HTML बॉडी के साथ HTTP 500 लौटता है, इसलिए status पढ़ने से पहले जांच लें कि रिस्पॉन्स JSON है।
सुझाव#
- खाली सूची:
"whatsapp_clients": []का मतलब है कि इस वर्कस्पेस में कोई नंबर कनेक्टेड नहीं है। WhatsApp सेटिंग्स में या नंबर कनेक्ट करें से एक नंबर कनेक्ट करें। - कई वर्कस्पेस: API की से तय होता है कि किस वर्कस्पेस की सूची मिलेगी। उसी वर्कस्पेस में बनाई गई की इस्तेमाल करें जो आपको चाहिए।
- सिर्फ एक नंबर: किसी एक नंबर को जांचने के लिए कनेक्शन स्टेटस इस्तेमाल करें।
