WhatsApp hesapları API'si
Bağlı WhatsApp numaralarını listeleme API'si
Çalışma alanınızda şu anda bağlı olan WhatsApp numaralarını alın. Kullanıcıların gönderim yapacakları numarayı seçmesini sağlamak veya diğer API çağrıları için whatsapp_client ID'sini bulmak için kullanın.
https://wbiztool.com/api/v1/whatsapp-client/list/Gövde: JSON veya form alanları
Yalnızca bağlı numaralar döndürülür. Bağlantısı kesik numaraları da görmek için Hesapları listeleme endpoint'ini kullanın.
Hızlı örnek#
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 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.
İ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.
Resmi istemcileri kullanma#
Python istemcisi bu endpoint'i sizin için çağırır.
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"])Python istemcisi, API HTTP 400 veya 403 döndürdüğünde requests.exceptions.HTTPError fırlatır; bu yüzden çağrıyı try/except içine alın.
Node.js istemcisinin getWhatsAppClients() yöntemi var olmayan bir adresi çağırır ve 404 ile başarısız olur. Hızlı örnek bölümündeki gibi fetch kullanın.
Yanıt#
Başarılı bir istek HTTP 200 döndürür:
{
"message": "okay",
"whatsapp_clients": [
{
"id": 678,
"whatsapp_client_id": 678,
"whatsapp_client_number": "919876543210",
"is_connected": true
}
],
"status": 1
}
| Alan | Tür | Açıklama |
|---|---|---|
status | integer | Başarıda 1, istek başarısız olduysa 0. |
message | string | Başarıda okay, aksi halde hata mesajı. |
whatsapp_clients | dizi | Bağlı numaralarınız. Hiçbiri bağlı değilse boştur. 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[].id | integer | whatsapp_client_id ile aynı değer. |
whatsapp_clients[].whatsapp_client_number | string | Numara eklendiğinde kaydedildiği haliyle telefon numarası. |
whatsapp_clients[].is_connected | boolean | Yalnızca bağlı numaralar listelendiği için her zaman true. |
Listenin sırası garanti edilmez. Sıra önemliyse whatsapp_client_id değerine göre sıralayın.
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. |
POST olmayan bir istek boş bir nesne {} döndürür. Beklenmeyen bir sunucu sorunu HTML gövdesiyle HTTP 500 döndürür; bu yüzden status değerini okumadan önce yanıtın JSON olduğunu kontrol edin.
İpuçları#
- Boş liste:
"whatsapp_clients": []bu çalışma alanında bağlı numara olmadığı anlamına gelir. WhatsApp ayarları sayfasından veya Numara bağlama ile bir numara bağlayı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.
- Yalnızca bir numara: tek bir numarayı kontrol etmek için Bağlantı durumu endpoint'ini kullanın.
