تست API تبدیل عدد به حروف فارسی

ابزار آنلاین برای تست و مشاهده نمونه استفاده از API

تست آنلاین API

مستندات API

GET https://saad.top/api/num2text/index.php?number={number}
نام نوع وضعیت توضیحات
number string اجباری عدد صحیح یا اعشاری (مثبت یا منفی). حداکثر 30 رقم.
نمونه پاسخ موفق: 
{
  "status": "success",
  "number": "123.45",
  "text": "صد و بیست و سه ممیز چهل و پنج"
}

نمونه استفاده در پروژه‌ها 

// تبدیل عدد به حروف با JavaScript (Fetch API)
async function numberToWords(number) {
    const apiUrl = 'https://saad.top/api/num2text/index.php';
    
    try {
        const response = await fetch(
            `${apiUrl}?number=${encodeURIComponent(number)}`
        );
        const data = await response.json();
        
        if (data.status === 'success') {
            console.log('متن:', data.text);
            return data.text;
        } else {
            console.error('خطا:', data.error);
        }
    } catch (error) {
        console.error('خطای شبکه:', error);
    }
}

// استفاده:
numberToWords(12345).then(text => {
    document.getElementById('output').innerText = text;
});

// استفاده با POST:
async function numberToWordsPost(number) {
    const apiUrl = 'https://saad.top/api/num2text/index.php';
    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: `number=${encodeURIComponent(number)}`
    });
    return await response.json();
}
<?php
// تبدیل عدد به حروف با PHP (cURL)
function numberToWords($number) {
    $apiUrl = 'https://saad.top/api/num2text/index.php';
    $url = $apiUrl . '?number=' . urlencode($number);
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode === 200) {
        $data = json_decode($response, true);
        if ($data['status'] === 'success') {
            return $data['text'];
        }
    }
    return null;
}

// استفاده:
echo numberToWords(12345);
// خروجی: دوازده هزار و سیصد و چهل و پنج

// استفاده با POST:
function numberToWordsPost($number) {
    $apiUrl = 'https://saad.top/api/num2text/index.php';
    $ch = curl_init($apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, ['number' => $number]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}
?>
# درخواست GET از طریق خط فرمان
curl "https://saad.top/api/num2text/index.php?number=12345"

# پاسخ:
# {"status":"success","number":"12345","text":"دوازده هزار و سیصد و چهل و پنج"}

# درخواست با عدد اعشاری
curl "https://saad.top/api/num2text/index.php?number=3.14"

# درخواست POST
curl -X POST "https://saad.top/api/num2text/index.php" \
     -d "number=12345"

# فقط متن خروجی را استخراج کنید (با jq)
curl -s "https://saad.top/api/num2text/index.php?number=123" \
     | jq -r '.text'
import requests

def number_to_words(number):
    api_url = "https://saad.top/api/num2text/index.php"
    
    try:
        response = requests.get(api_url, params={"number": number}, timeout=10)
        response.raise_for_status()
        data = response.json()
        
        if data.get("status") == "success":
            return data["text"]
        else:
            print(f"خطا: {data.get('error')}")
    except requests.exceptions.RequestException as e:
        print(f"خطای شبکه: {e}")
    
    return None

# استفاده:
text = number_to_words(12345)
print(text)  # دوازده هزار و سیصد و چهل و پنج

# استفاده با POST:
def number_to_words_post(number):
    api_url = "https://saad.top/api/num2text/index.php"
    response = requests.post(api_url, data={"number": number}, timeout=10)
    return response.json()

طراحی شده توسط Saad