Status pengesahan nombor WhatsApp (API)

Semak kemajuan tugas pengesahan nombor dan dapatkan keputusan bagi setiap nombor di dalamnya. Tinjau endpoint ini selepas mencipta tugas pengesahan sehingga tugas itu selesai.

Contoh ringkas#

curl "https://wbiztool.com/api/v1/verification/status/?campaign_id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://wbiztool.com/api/v1/verification/status/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"campaign_id": 4521},
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 4xx or 5xx

if result["status"] == "success":
    progress = result["progress"]
    print(result["overall_status"], f"{progress['completed_percentage']}% done")
    for item in result["results"]:
        print(item["number"], item["status"])
else:
    print(f"Failed ({response.status_code}):", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const url = new URL("https://wbiztool.com/api/v1/verification/status/");
url.searchParams.set("campaign_id", "4521");

const response = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const result = await response.json(); // read the body even when the HTTP code is 4xx or 5xx

if (result.status === "success") {
  console.log(result.overall_status, `${result.progress.completed_percentage}% done`);
  for (const item of result.results) {
    console.log(item.number, item.status);
  }
} else {
  console.error(`Failed (${response.status}):`, result.message);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v1/verification/status/?campaign_id=4521');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? '') === 'success') {
    echo $result['overall_status'] . ' - ' . $result['progress']['completed_percentage'] . "% done\n";
    foreach ($result['results'] as $item) {
        echo $item['number'] . ': ' . $item['status'] . "\n";
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

Parameter permintaan#

Respons#

Permintaan yang berjaya memulangkan HTTP 200:

{
  "status": "success",
  "campaign_id": 4521,
  "campaign_name": "Website leads - September",
  "overall_status": "processing",
  "progress": {
    "total": 3,
    "pending": 1,
    "verified": 1,
    "invalid": 1,
    "completed_percentage": 66.67
  },
  "results": [
    {
      "number": "14155550123",
      "status": "pending",
      "checked_at": null,
      "created_at": "2026-09-16T10:15:00.483101+00:00"
    },
    {
      "number": "919876543210",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:12.204551+00:00",
      "created_at": "2026-09-16T10:15:00.482913+00:00"
    },
    {
      "number": "919876543211",
      "status": "invalid",
      "checked_at": "2026-09-16T10:16:19.915372+00:00",
      "created_at": "2026-09-16T10:15:00.483020+00:00"
    }
  ],
  "created_at": "2026-09-16T10:15:00.471820+00:00",
  "last_updated": "2026-09-16T10:15:00.471820+00:00"
}

Semua cap masa dalam ISO 8601 dalam UTC dengan mikrosaat dan ofset +00:00, contohnya 2026-09-16T10:16:12.204551+00:00.

Nilai status nombor#

Nilai status keseluruhan#

Tugas completed boleh menunjukkan completed_percentage di bawah 100 jika sesetengah semakan dibatalkan, kerana nombor yang dibatalkan dikira dalam total tetapi tidak dalam peratusan.

Ralat#

Ralat memulangkan badan JSON dengan status ditetapkan kepada "error" dan kod ralat HTTP:

{ "status": "error", "message": "Campaign not found" }

Petua#

• Tinjau secara berpada-pada. Sehingga 10 nombor disemak bagi setiap pusingan di latar belakang, jadi menyemak setiap 30 hingga 60 saat sudah memadai, dan tugas yang besar boleh mengambil masa yang lama.
• Berhenti meninjau apabila overall_status ialah completed.
• Tersekat pada pending? Pengesahan memerlukan nombor WhatsApp yang disambungkan di tetapan WhatsApp dalam ruang kerja yang sama. Tanpanya, nombor tidak akan disemak. Semakan juga menunggu semasa nombor anda yang disambungkan sibuk menghantar mesej.
• Tugas besar: endpoint ini memulangkan setiap nombor dalam satu respons. Untuk membaca keputusan halaman demi halaman, atau hanya nombor verified, gunakan Keputusan pengesahan.