WhatsApp hesapları API'si
WhatsApp hesaplarını listeleme API'si
Tüm WhatsApp numaralarınızın ve bağlantı durumlarının eksiksiz listesini tek bir çağrıda almak için bu API'yi kullanın. Bağlı numaraları listeleme endpoint'inden farklı olarak bağlantısı kesik numaraları da içerir.
https://wbiztool.com/api/v1/whatsapp/accounts/Gövde: JSON veya form alanları
| Fark | Hesapları listeleme | Bağlı numaraları listeleme |
|---|---|---|
| Bağlantısı kesik ve silinmiş numaraları içerir | Evet | Hayır |
| Öğe anahtarları | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
Başarıda message | Yok | okay |
Hızlı örnek#
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');
}12345 ve YOUR_API_KEY değerlerini kendi değerlerinizle değiştirin. Bunları nerede bulacağınız için Kimlik doğrulama bölümüne bakın.
Resmi istemcilerin hiçbirinde bu endpoint için bir yöntem yoktur; bu yüzden örneklerdeki gibi doğrudan çağırın.
İstek parametreleri#
client_idintegerzorunluAyarlar → API anahtarları sayfasındaki API Client ID'niz.
api_keystringzorunluAynı sayfadaki API anahtarınız. Liste, bu anahtarın oluşturulduğu çalışma alanı içindir.
Yanıt#
Başarılı bir istek HTTP 200 döndürür:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| Alan | Tür | Açıklama |
|---|---|---|
status | integer | Başarıda 1, istek başarısız olduysa 0. |
whatsapp_clients | dizi | Bu çalışma alanına şimdiye kadar eklenmiş her WhatsApp numarası. Yalnızca başarıda bulunur. |
whatsapp_clients[].whatsapp_client_id | integer | Numaranın ID'si. Diğer API çağrılarında whatsapp_client olarak iletin. |
whatsapp_clients[].whatsapp_number | string | Eklendiğinde kaydedildiği haliyle telefon numarası. |
whatsapp_clients[].status | string | connected veya not_connected. |
Listenin sırası garanti edilmez. Sıra önemliyse whatsapp_client_id değerine göre sıralayın.
Başarılı bir yanıtta message alanı yoktur; bu yüzden örneklerdeki gibi bir yedek değerle okuyun.
Hatalar#
| Mesaj | HTTP | Nasıl düzeltilir |
|---|---|---|
Auth Error | 200 | client_id ve api_key değerlerinin ikisini de bir POST gövdesinde, geçerli JSON veya form alanları olarak gönderin. |
Invalid Client Id | 403 | client_id değerini 12345 gibi bir tam sayı olarak gönderin. |
Auth Error: invalid api key | 400 | Anahtarın mevcut olduğunu, silinmediğini ve bu client_id değerine ait olduğunu kontrol edin. |
Sunucu beklenmeyen bir sorunla karşılaşırsa veya istek POST değilse, yanıt boş bir nesnedir: {}. status alanı olmayan yanıtı başarısızlık olarak değerlendirin.
İpuçları#
- Bir numarayı yeniden bağlama:
not_connecteddurumundaki bir numara WhatsApp ayarları sayfasından veya Numara bağlama ile yeniden bağlanabilir. - Yalnızca bir numara: tek bir numarayı kontrol etmek için Bağlantı durumu endpoint'ini kullanın.
- Birden fazla çalışma alanı: hangi çalışma alanının listeleneceğini API anahtarı belirler. İstediğiniz çalışma alanında oluşturulmuş bir anahtar kullanın.
