📡 نسخه 1.0

وب‌سرویس ارسال کد تأیید بله

ارسال کد تأیید به کاربران پیام‌رسان بله از طریق یک API ساده و امن. مناسب برای سایت‌ها، اپلیکیشن‌ها و سرویس‌های احراز هویت.

🔗 نقطه پایان (Endpoint)

POST https://net-visit.ir/api/bale/api.php

تنها متد POST پذیرفته می‌شود. بدنه درخواست باید به صورت JSON ارسال گردد.

📥 پارامترهای ورودی

پارامتر نوع اجباری توضیح
phone string * بله شماره تلفن کاربر با فرمت 09936350160
code string * بله کد تأیید ارسالی (مثلاً 123456)
source string (اختیاری) نام مبدا / سایت درخواست‌دهنده (مثلاً Google, Instagram)
💡 نکته مهم: کاربر باید ابتدا در ربات بله ثبت‌نام کرده باشد. در غیر این صورت کد ذخیره شده ولی پیامی ارسال نمی‌شود.

🧪 نمونه کدهای درخواست

cURL
curl -X POST "https://net-visit.ir/api/bale/api.php" \
     -H "Content-Type: application/json" \
     -d '{
          "phone": "09936350160",
          "code": "837462",
          "source": "Google"
     }'
PHP
$url = 'https://net-visit.ir/api/bale/api.php';
$data = [
    'phone'  => '09936350160',
    'code'   => '837462',
    'source' => 'Google'
];

$options = [
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/json',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);

if ($response['ok']) {
    echo "کد با موفقیت ارسال شد!";
} else {
    echo "خطا: " . $response['error'];
}
Python
import requests
import json

url = "https://net-visit.ir/api/bale/api.php"
payload = {
    "phone": "09936350160",
    "code": "837462",
    "source": "Google"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload)
data = response.json()

if data.get("ok"):
    print("کد ارسال شد!", data)
else:
    print("خطا:", data.get("error"))
JavaScript
const url = 'https://net-visit.ir/api/bale/api.php';
const payload = {
    phone: '09936350160',
    code: '837462',
    source: 'Google'
};

fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload)
})
.then(res => res.json())
.then(data => {
    if (data.ok) {
        console.log('✅ کد ارسال شد!', data);
    } else {
        console.log('❌ خطا:', data.error);
    }
})
.catch(err => console.error('خطای شبکه:', err));

📤 پاسخ‌های سرور

✅ درخواست موفق

{ "ok": true, "message": "کد با موفقیت ذخیره و ارسال شد", "chat_id": "1205207551", "phone": "09936350160", "code": "837462", "source": "Google", "saved": true, "sent": true }

❌ کاربر ثبت‌نام نکرده

{ "ok": false, "error": "کاربر با این شماره در ربات ثبت‌نام نکرده است", "phone": "09936350160" }

❌ پارامتر ناقص

{ "ok": false, "error": "پارامترهای phone و code الزامی هستند" }

📘 راهنمای کامل

برای استفاده از این وب‌سرویس مراحل زیر را دنبال کنید:

  1. کاربر باید در ربات بله به آدرس @Verify_user_bot باید استارت کند و شماره تلفن را ثبت کند
  2. از سمت سایت یا اپلیکیشن خود، درخواست POST به آدرس API ارسال کنید.
  3. پارامترهای phone و code را حتماً ارسال کنید. پارامتر source اختیاری است.
  4. در صورت موفقیت، کد در codes.json ذخیره شده و به کاربر در بله پیام داده می‌شود.
  5. پاسخ JSON دریافت کرده و بر اساس فیلد ok موفقیت یا خطا را بررسی کنید.