スタートガイド
認証情報の確認API
ほかのAPIを呼び出す前に、このAPIで認証情報を検証できます。client_idとapi_keyの組み合わせが有効であること、また必要に応じてWhatsApp番号のIDがワークスペースに属していることを確認します。メッセージは送信されず、クレジットも消費しません。
https://wbiztool.com/api/v1/me/リクエストボディ: JSONまたはフォームフィールド
クイック例#
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、678はご自身の値に置き換えてください。APIキーだけをテストしたい場合はwhatsapp_clientを省略してください。値の確認場所は認証をご覧ください。
リクエストパラメータ#
client_idinteger必須設定 → APIキーに表示されるAPIクライアントIDです。
api_keystring必須同じページにあるAPIキーです。
whatsapp_clientinteger任意WhatsApp設定に表示される、いずれかのWhatsApp番号のIDです。送信すると、そのIDがこのAPIキーのワークスペースに属しているかどうかもあわせて確認します。ダッシュボードから削除した番号でも、この確認は通過します。確認するのはIDのみで、番号が接続されているかどうかはわかりません。接続状態は接続ステータスで確認してください。
レスポンス#
リクエストが成功すると、HTTP 200が返ります。
{
"status": 1,
"message": "Okay",
"name": "[email protected] - 919876543210"
}
| フィールド | 型 | 説明 |
|---|---|---|
status | integer | 認証情報が有効な場合は1、無効な場合は0。 |
message | string | 成功時はOkay、それ以外はエラー内容。 |
name | string | ワークスペースを作成した人のユーザー名。whatsapp_clientを送信した場合は、-の後にその番号の電話番号が付加されます。成功時のみ含まれます。 |
エラー#
このエンドポイントの失敗はすべてHTTP 400で返ります。ただし、client_idが数値でない場合はHTTP 403が返ります。ボディのstatusは常に0です。
{ "status": 0, "message": "Auth Error: invalid api key" }
| メッセージ | 対処方法 |
|---|---|
Auth Error | client_idとapi_keyの両方を、有効なJSONまたはフォームフィールドとしてPOSTボディで送信してください。whatsapp_clientが数値でない場合にもこのメッセージが表示されます。 |
Invalid Client Id | client_idは12345のような整数で送信してください。 |
Auth Error: invalid api key | キーが存在し、削除されておらず、このclient_idに属していることを確認してください。 |
Invalid WhatsApp Client ID | そのwhatsapp_client IDはこのAPIキーのワークスペースにありません。WhatsApp設定からIDをコピーしてください。 |
APIの稼働確認#
/api/v1/status/はシンプルな死活監視用エンドポイントです。認証情報は不要で、どのメソッドでも受け付け、常に次の内容を返します。
{ "status": 200, "data": {} }
わかるのはAPIに到達できるかどうかだけです。認証情報や、WhatsApp番号が接続されているかどうかは確認しません。
curl https://wbiztool.com/api/v1/status/
Pythonクライアントのhealth_check()はこのエンドポイントを呼び出します。
ヒント#
- 確認は設定時に1回:メッセージを送るたびではなく、ユーザーがアプリで認証情報を保存したときにこのエンドポイントを呼び出してください。確認が成功しても、送信できるとは限りません。残りのクレジットや番号が接続されているかどうかは確認されません。
- エラー時もボディを読む:失敗はHTTP
400または403で返るため、その場合でもHTTPクライアントがJSONボディを解析するようにしてください。 - 削除したキーはすぐに使えなくなる:APIキーのページでキーが削除されている場合、
Auth Error: invalid api keyが返ります。 - 次のステップ:認証情報が有効であることを確認したら、メッセージを送信しましょう。
