API akaun WhatsApp
API Senarai Nombor WhatsApp Disambungkan
Dapatkan nombor WhatsApp dalam ruang kerja anda yang boleh menghantar sekarang, atau yang mesejnya menunggu pelayarnya. Gunakannya untuk membolehkan pengguna memilih nombor untuk menghantar, atau untuk mencari ID whatsapp_client bagi panggilan API lain.
https://wbiztool.com/api/v1/whatsapp-client/list/Body: JSON atau medan borang
Nombor yang disambungkan dipulangkan, serta nombor sambungan Chrome yang pelayarnya ditutup (status waiting_for_browser): anda boleh menghantar daripadanya, dan mesejnya menunggu sehingga pelayar kembali. Untuk turut melihat nombor yang terputus sambungan, gunakan Senarai akaun. Akaun Telegram yang disambungkan turut disenaraikan, dengan platform ditetapkan kepada telegram.
Contoh ringkas#
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');
}Gantikan 12345 dan YOUR_API_KEY dengan nilai anda sendiri. Lihat Pengesahan identiti untuk mengetahui di mana nilai ini boleh didapati.
Parameter permintaan#
AuthorizationheaderDisyorkanBearer YOUR_API_KEY: kunci API anda dari Tetapan → Kunci API. Dengan pengepala ini,client_iddanapi_keyboleh ditinggalkan daripada badan; jika kedua-duanya dihantar, kunci sah dalam pengepala yang digunakan. Lihat Hantar kunci dalam pengepala.client_idintegerTanpa pengepala AuthorizationAPI Client ID anda dari Tetapan → Kunci API. Pilihan dengan pengepala; jika anda menghantarnya, ia mestilah Client ID ruang kerja kunci itu.
api_keystringTanpa pengepala AuthorizationKunci API anda dari halaman yang sama, apabila anda tidak menghantarnya dalam pengepala. Senarai ini adalah untuk ruang kerja tempat kunci ini dicipta.
Menggunakan klien rasmi#
Klien Python memanggil endpoint ini untuk anda.
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"])Klien Python menimbulkan requests.exceptions.HTTPError apabila API memulangkan HTTP 400 atau 403, jadi balut panggilan dalam try/except.
getWhatsAppClients() klien Node.js memanggil alamat yang tidak wujud dan gagal dengan 404. Gunakan fetch seperti dalam Contoh ringkas.
Respons#
Permintaan yang berjaya memulangkan HTTP 200:
{
"message": "okay",
"whatsapp_clients": [
{
"id": 678,
"whatsapp_client_id": 678,
"whatsapp_client_number": "919876543210",
"platform": "whatsapp",
"is_connected": true,
"status": "connected"
},
{
"id": 702,
"whatsapp_client_id": 702,
"whatsapp_client_number": "919812345670",
"platform": "telegram",
"is_connected": true,
"status": "connected"
},
{
"id": 731,
"whatsapp_client_id": 731,
"whatsapp_client_number": "919898989898",
"platform": "whatsapp",
"is_connected": false,
"status": "waiting_for_browser"
}
],
"status": 1
}
| Medan | Jenis | Penerangan |
|---|---|---|
status | integer | 1 jika berjaya, 0 jika permintaan gagal. |
message | string | okay jika berjaya, jika tidak, mesej ralat. |
whatsapp_clients | tatasusunan | Nombor anda yang disambungkan dan nombor sambungan yang menunggu pelayarnya. Kosong jika tiada. Hanya ada jika berjaya. |
whatsapp_clients[].whatsapp_client_id | integer | ID nombor. Hantarkannya sebagai whatsapp_client dalam panggilan API lain. |
whatsapp_clients[].id | integer | Nilai yang sama seperti whatsapp_client_id. |
whatsapp_clients[].whatsapp_client_number | string | Nombor telefon seperti yang disimpan semasa nombor itu ditambah. |
whatsapp_clients[].platform | string | whatsapp untuk nombor WhatsApp, telegram untuk akaun Telegram. Hantar daripada mana-mana satu dengan ID-nya sebagai whatsapp_client. |
whatsapp_clients[].is_connected | boolean | true bagi nombor yang disambungkan, false bagi nombor sambungan yang menunggu pelayarnya. |
whatsapp_clients[].status | string | connected: nombor itu menghantar sekarang. waiting_for_browser: nombor sambungan Chrome yang pelayarnya ditutup; mesej yang dihantar daripadanya menunggu dan dihantar apabila pelayar kembali, atau tamat tempoh selepas 48 jam. |
Susunan senarai tidak dijamin. Isih mengikut whatsapp_client_id jika susunan penting.
Ralat#
| Mesej | HTTP | Cara membetulkannya |
|---|---|---|
Auth Error | 200 | Hantar kedua-dua client_id dan api_key dalam badan POST, sebagai JSON atau medan borang yang sah. |
Invalid Client Id | 403 | Hantar client_id sebagai nombor bulat, seperti 12345. |
Auth Error: invalid api key | 400 | Pastikan kunci wujud, belum dipadam dan milik client_id ini. |
Permintaan yang bukan POST memulangkan objek kosong {}. Masalah pelayan yang tidak dijangka memulangkan HTTP 500 dengan badan HTML, jadi pastikan respons ialah JSON sebelum membaca status.
Petua#
- Senarai kosong:
"whatsapp_clients": []bermaksud tiada nombor yang disambungkan dalam ruang kerja ini, dan tiada nombor sambungan yang menunggu pelayarnya. Sambung satu nombor di tetapan WhatsApp atau dengan Sambung nombor. - Beberapa ruang kerja: kunci API menentukan ruang kerja yang disenaraikan. Gunakan kunci yang dicipta dalam ruang kerja yang anda mahu.
- Satu nombor sahaja: untuk menyemak satu nombor, gunakan Status sambungan.

