Başlarken

Kimlik bilgilerini kontrol etme API'si

Diğer API çağrılarını yapmadan önce kimlik bilgilerinizi doğrulamak için bu API'yi kullanın. client_id ve api_key değerlerinizin birlikte çalıştığını ve isteğe bağlı olarak bir WhatsApp numara ID'sinin çalışma alanınıza ait olduğunu doğrular. Hiçbir şey göndermez ve kredi harcamaz.

POSThttps://wbiztool.com/api/v1/me/

Gövde: JSON veya form alanları

Hızlı örnek#

curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/me/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
    },
    timeout=30,
)
result = response.json()  # read the body even when the HTTP code is 400 or 403

if result["status"] == 1:
    print("Credentials OK for", result["name"])
else:
    print("Failed:", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/me/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403

if (result.status === 1) {
  console.log("Credentials OK for", result.name);
} else {
  console.error("Failed:", result.message);
}

<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
];

$ch = curl_init('https://wbiztool.com/api/v1/me/');
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) {
    echo 'Credentials OK for ' . $result['name'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

12345, YOUR_API_KEY ve 678 değerlerini kendi değerlerinizle değiştirin. Yalnızca anahtarı test etmek istiyorsanız whatsapp_client alanını göndermeyin. Bu değerleri 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.
whatsapp_clientintegeristeğe bağlı: WhatsApp ayarları sayfasındaki WhatsApp numaralarınızdan birinin ID'si. ID'nin bu API anahtarının çalışma alanına ait olduğunu da kontrol etmek için gönderin. Panelden sildiğiniz bir numara da bu kontrolden geçer. Yalnızca ID'yi kontrol eder; numaranın bağlı olup olmadığını söylemez. Bunun için Bağlantı durumu endpoint'ini kullanın.

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

{
  "status": 1,
  "message": "Okay",
  "name": "[email protected] - 919876543210"
}

Alan	Tür	Açıklama
`status`	integer	Kimlik bilgileri geçerliyse `1`, değilse `0`.
`message`	string	Başarıda `Okay`, aksi halde hata mesajı.
`name`	string	Çalışma alanını oluşturan kişinin kullanıcı adı. `whatsapp_client` gönderdiyseniz, numaranın telefonu `-` ifadesinden sonra eklenir. Yalnızca başarıda bulunur.

Hatalar#

Bu endpoint'teki her hata HTTP 400 döndürür; yalnızca sayısal olmayan bir client_id HTTP 403 döndürür. Gövdede status her zaman 0 olur:

{ "status": 0, "message": "Auth Error: invalid api key" }

Mesaj	Nasıl düzeltilir
`Auth Error`	`client_id` ve `api_key` değerlerinin ikisini de bir `POST` gövdesinde, geçerli JSON veya form alanları olarak gönderin. Bu mesaj `whatsapp_client` bir sayı olmadığında da görünür.
`Invalid Client Id`	`client_id` değerini `12345` gibi bir tam sayı olarak gönderin.
`Auth Error: invalid api key`	Anahtarın mevcut olduğunu, silinmediğini ve bu `client_id` değerine ait olduğunu kontrol edin.
`Invalid WhatsApp Client ID`	Bu `whatsapp_client` ID'si bu API anahtarının çalışma alanında değil. ID'yi WhatsApp ayarları sayfasından kopyalayın.

API'nin çalıştığını kontrol etme#

/api/v1/status/ basit bir erişilebilirlik kontrolüdür. Kimlik bilgisi gerektirmez, her yöntemi kabul eder ve her zaman şunu döndürür:

{ "status": 200, "data": {} }

Yalnızca API'ye erişilebildiğini söyler. Kimlik bilgilerinizi veya WhatsApp numaranızın bağlı olup olmadığını kontrol etmez.

curl https://wbiztool.com/api/v1/status/

Python istemcisinin health_check() yöntemi bu endpoint'i çağırır.

İpuçları#

Kurulumda bir kez kontrol edin: bu endpoint'i her mesajdan önce değil, bir kullanıcı uygulamanızda kimlik bilgilerini kaydettiğinde çağırın. Başarılı bir kontrol gönderim yapabileceğiniz anlamına gelmez: kalan kredilerinize veya numaranızın bağlı olup olmadığına bakmaz.
Hatalarda gövdeyi okuyun: hatalar HTTP 400 veya 403 olarak döner; bu yüzden HTTP istemcinizin JSON gövdesini yine de ayrıştırdığından emin olun.
Silinen anahtarlar hemen çalışmayı durdurur: bir anahtar API anahtarları sayfasında silindiyse Auth Error: invalid api key hatası alırsınız.
Sonraki adım: kimlik bilgileriniz çalıştığında bir mesaj gönderin.