Langkau ke kandungan
Wbiztool

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.

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

Body: JSON atau medan borang

PerbezaanSenarai akaunSenarai nombor disambungkan
Merangkumi nombor yang terputus sambungan dan dipadamYaTidak
Kunci itemwhatsapp_client_id, whatsapp_number, statusid, whatsapp_client_id, whatsapp_client_number, is_connected
message jika berjayaTidak disertakanokay

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

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_idintegerwajib

API Client ID anda dari Settings → API keys (Tetapan → Kunci API).

api_keystringwajib

Kunci 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
}
MedanJenisPenerangan
statusinteger1 jika berjaya, 0 jika permintaan gagal.
whatsapp_clientstatasusunanSetiap nombor WhatsApp yang pernah ditambah ke ruang kerja ini. Hanya ada jika berjaya.
whatsapp_clients[].whatsapp_client_idintegerID nombor. Hantarkannya sebagai whatsapp_client dalam panggilan API lain.
whatsapp_clients[].whatsapp_numberstringNombor telefon seperti yang disimpan semasa ia ditambah.
whatsapp_clients[].statusstringconnected 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#

MesejHTTPCara membetulkannya
Auth Error200Hantar kedua-dua client_id dan api_key dalam badan POST, sebagai JSON atau medan borang yang sah.
Invalid Client Id403Hantar client_id sebagai nombor bulat, seperti 12345.
Auth Error: invalid api key400Pastikan 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_connected boleh 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.