API akaun WhatsApp
API Senarai Akaun WhatsApp
Gunakan API ini untuk mendapatkan senarai lengkap semua nombor WhatsApp anda dan status sambungannya, dalam satu panggilan. Tidak seperti Senarai nombor disambungkan, ia turut merangkumi nombor yang terputus sambungan.
https://wbiztool.com/api/v1/whatsapp/accounts/Body: JSON atau medan borang
| Perbezaan | Senarai akaun | Senarai nombor disambungkan |
|---|---|---|
| Merangkumi nombor yang terputus sambungan dan dipadam | Ya | Tidak |
| Kunci item | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
message jika berjaya | Tidak disertakan | okay |
Contoh ringkas#
curl -X POST https://wbiztool.com/api/v1/whatsapp/accounts/ \
-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/accounts/",
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 account in result["whatsapp_clients"]:
print(account["whatsapp_client_id"], account["whatsapp_number"], account["status"])
else:
print("Failed:", result.get("message", "no response"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp/accounts/", {
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 account of result.whatsapp_clients) {
console.log(account.whatsapp_client_id, account.whatsapp_number, account.status);
}
} else {
console.error("Failed:", result.message ?? "no response");
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp/accounts/');
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 $account) {
echo $account['whatsapp_client_id'] . ' ' . $account['whatsapp_number'] . ' ' . $account['status'] . 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.
Kedua-dua klien rasmi tiada kaedah untuk endpoint ini, jadi panggil secara terus seperti dalam contoh.
Parameter permintaan#
client_idintegerwajibAPI Client ID anda dari Settings → API keys (Tetapan → Kunci API).
api_keystringwajibKunci API anda dari halaman yang sama. Senarai ini adalah untuk ruang kerja tempat kunci ini dicipta.
Respons#
Permintaan yang berjaya memulangkan HTTP 200:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| Medan | Jenis | Penerangan |
|---|---|---|
status | integer | 1 jika berjaya, 0 jika permintaan gagal. |
whatsapp_clients | tatasusunan | Setiap nombor WhatsApp yang pernah ditambah ke ruang kerja ini. Hanya ada jika berjaya. |
whatsapp_clients[].whatsapp_client_id | integer | ID nombor. Hantarkannya sebagai whatsapp_client dalam panggilan API lain. |
whatsapp_clients[].whatsapp_number | string | Nombor telefon seperti yang disimpan semasa ia ditambah. |
whatsapp_clients[].status | string | connected atau not_connected. |
Susunan senarai tidak dijamin. Isih mengikut whatsapp_client_id jika susunan penting.
Respons yang berjaya tiada medan message, jadi bacanya dengan nilai sandaran seperti dalam contoh.
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. |
Jika pelayan mengalami masalah yang tidak dijangka, atau permintaan bukan POST, respons ialah objek kosong: {}. Anggap status yang tiada sebagai kegagalan.
Petua#
- Menyambung semula nombor: nombor
not_connectedboleh disambungkan semula di tetapan WhatsApp atau dengan Sambung nombor. - Satu nombor sahaja: untuk menyemak satu nombor, gunakan Status sambungan.
- Beberapa ruang kerja: kunci API menentukan ruang kerja yang disenaraikan. Gunakan kunci yang dicipta dalam ruang kerja yang anda mahu.
