İçeriğe geç
Wbiztool

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.

POSThttps://wbiztool.com/api/v1/whatsapp/accounts/

Gövde: JSON veya form alanları

FarkHesapları listelemeBağlı numaraları listeleme
Bağlantısı kesik ve silinmiş numaraları içerirEvetHayır
Öğe anahtarlarıwhatsapp_client_id, whatsapp_number, statusid, whatsapp_client_id, whatsapp_client_number, is_connected
Başarıda messageYokokay

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"
  }'

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_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.

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
}
AlanTürAçıklama
statusintegerBaşarıda 1, istek başarısız olduysa 0.
whatsapp_clientsdiziBu çalışma alanına şimdiye kadar eklenmiş her WhatsApp numarası. 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[].whatsapp_numberstringEklendiğinde kaydedildiği haliyle telefon numarası.
whatsapp_clients[].statusstringconnected 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#

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.

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_connected durumundaki 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.