İçeriğe geç
Wbiztool

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.

POSThttps://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"
  }'

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_idintegerzorunlu

Ayarlar → API anahtarları sayfasındaki API Client ID'niz.

api_keystringzorunlu

Aynı 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.

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"])

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
}
AlanTürAçıklama
statusintegerBaşarıda 1, istek başarısız olduysa 0.
messagestringBaşarıda okay, aksi halde hata mesajı.
whatsapp_clientsdiziBağlı numaralarınız. Hiçbiri bağlı değilse boştur. Yalnızca başarıda bulunur.
whatsapp_clients[].whatsapp_client_idintegerNumaranın ID'si. Diğer API çağrılarında whatsapp_client olarak iletin.
whatsapp_clients[].idintegerwhatsapp_client_id ile aynı değer.
whatsapp_clients[].whatsapp_client_numberstringNumara eklendiğinde kaydedildiği haliyle telefon numarası.
whatsapp_clients[].is_connectedbooleanYalnı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#

MesajHTTPNasıl düzeltilir
Auth Error200client_id ve api_key değerlerinin ikisini de bir POST gövdesinde, geçerli JSON veya form alanları olarak gönderin.
Invalid Client Id403client_id değerini 12345 gibi bir tam sayı olarak gönderin.
Auth Error: invalid api key400Anahtarı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.