فلزات گران بها

28 تومان / ریکوئست

وب سرویس قیمت طلا

20 فوریه 2026 1 دقیقه

GET


                                /v1/gold/

در دنیای امروز، دسترسی سریع و دقیق به قیمت لحظه‌ای طلا برای وب‌سایت‌های مالی، صرافی‌ها، اپلیکیشن‌های سرمایه‌گذاری و پلتفرم‌های تحلیلی یک ضرورت محسوب می‌شود. استفاده از وب‌سرویس قیمت طلا (Gold Price API) بهترین راهکار برای دریافت داده‌های به‌روز، پایدار و قابل اعتماد است.

معرفی وب‌سرویس

وب‌سرویس قیمت طلا یک API آنلاین است که امکان دریافت قیمت لحظه‌ای طلا، تغییرات روزانه، نمودارها و اطلاعات بازار را به‌صورت خودکار فراهم می‌کند. این داده‌ها معمولاً بر اساس بازارهای جهانی مانند London Bullion Market یا منابع معتبر بین‌المللی ارائه می‌شوند.

اهمیت استفاده از API

دریافت قیمت طلا به‌صورت Real-Time
کاهش خطای انسانی در به‌روزرسانی قیمت‌ها
افزایش اعتماد کاربران و اعتبار سایت
امکان استفاده در وب‌سایت، اپلیکیشن موبایل و نرم‌افزارهای مالی

ویژگی‌های وب‌سرویس

هنگام انتخاب یک وب‌سرویس قیمت طلا، توجه به ویژگی‌های زیر بسیار مهم است:

پایداری و Uptime بالا
سرعت پاسخ‌دهی مناسب (Low Latency)
دقت و صحت داده‌ها
پشتیبانی از فرمت‌های JSON و REST
مستندات فنی کامل و شفاف

کاربردهای وب‌سرویس

API قیمت طلا در پروژه‌های مختلفی قابل استفاده است، از جمله:

وب‌سایت‌های خبری و تحلیلی بازارهای مالی
اپلیکیشن‌های سرمایه‌گذاری و ترید
سیستم‌های حسابداری و مالی
پلتفرم‌های مقایسه قیمت

سؤالات متداول

آیا قیمت طلا به‌صورت لحظه‌ای به‌روزرسانی می‌شود؟

بله، وب‌سرویس‌های حرفه‌ای قیمت طلا را در بازه‌های زمانی کوتاه (چند ثانیه تا چند دقیقه) به‌روزرسانی می‌کنند.

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

برای استفاده مستقیم از API، دانش پایه برنامه‌نویسی کافی است. با این حال، بسیاری از سیستم‌ها پلاگین یا ماژول آماده نیز ارائه می‌دهند.

آیا داده‌های وب‌سرویس قیمت طلا قابل اعتماد هستند؟

در صورتی که وب‌سرویس از منابع معتبر بازار جهانی استفاده کند، داده‌ها از دقت و اعتبار بالایی برخوردار خواهند بود.

آیا امکان استفاده تجاری از وب‌سرویس قیمت طلا وجود دارد؟

بله، اکثر ارائه‌دهندگان API پلن‌های تجاری با محدودیت کمتر و پشتیبانی حرفه‌ای ارائه می‌کنند.

کدهای خطا و وضعیت‌ها

لیست تمام پاسخ‌های احتمالی که ممکن است از API دریافت کنید.

کد	وضعیت	توضیحات فنی و راه حل
200	OK	درخواست با موفقیت پردازش شد و نتیجه برگردانده شد.
201	Created	منبع جدید (مثلاً سفارش یا کاربر) با موفقیت ساخته شد.
400	Bad Request	پارامترهای ارسالی اشتباه هستند. لطفاً مستندات را چک کنید (مثلاً فرمت شماره موبایل غلط است).
401	Unauthorized	توکن دسترسی (API Key) ارسال نشده یا نامعتبر است. هدر Authorization را بررسی کنید.
402	Payment Required	اعتبار حساب شما کافی نیست. لطفاً پنل کاربری را شارژ کنید.
403	Forbidden	دسترسی غیرمجاز. IP شما در لیست مجاز نیست یا دامنه شما تایید نشده است.
404	Not Found	اطلاعات درخواستی پیدا نشد (مثلاً شناسه تراکنش یا کاربر وجود ندارد).
405	Method Not Allowed	متد درخواستی اشتباه است. (مثلاً به جای POST از GET استفاده کرده‌اید).
429	Too Many Requests	تعداد درخواست‌های شما بیش از حد مجاز است (Rate Limit). لطفاً ۱ دقیقه صبر کنید.
500	Internal Server Error	خطای سمت سرور. مشکلی در پردازش پیش آمده است، لطفاً با پشتیبانی تماس بگیرید.
502	Bad Gateway	سرویس در حال بروزرسانی یا تعمیر است. لطفاً چند لحظه بعد تلاش کنید.
503	Service Unavailable	ترافیک سرور بالاست. لطفاً درخواست را مجدداً ارسال کنید.

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

پارامتر	نوع	الزام	توضیحات
license	String	YES	جهت دریافت لایسنس کلیک کنید.

نمونه کد

import requests

url = "https://api.digiwebify.ir/v1/gold/"

params = {
    "license": "YOUR_LICENSE_KEY"
}

headers = {
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers, timeout=15)
response.raise_for_status()

print(response.json())

const url = new URL("https://api.digiwebify.ir/v1/gold/");
url.searchParams.append("license", "YOUR_LICENSE_KEY");

const res = await fetch(url, {
  headers: {
    "Accept": "application/json",
  },
});

const data = await res.json();
console.log(data);

<?php

$url = 'https://api.digiwebify.ir/v1/gold/?' . http_build_query([
    'license' => 'YOUR_LICENSE_KEY',
]);

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException('cURL Error: ' . curl_error($ch));
}

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode !== 200) {
    throw new RuntimeException("HTTP Error {$httpCode}: {$response}");
}

echo $response;

curl -X GET "https://api.digiwebify.ir/v1/gold/?license=YOUR_LICENSE_KEY" 
  -H "Accept: application/json"

خروجی و تست

JSON Response 200 OK

{
    "success": true,
    "code": 200,
    "message": "OK",
    "description": "درخواست با موفقیت انجام شد.",
    "data": {
        "currency": "IRR",
        "unit": "price",
        "prices": {
            "gold_18_price": "198,846,000",
            "gold_24_price": "265,125,000",
            "coin_emami": "2,010,100,000",
            "coin_bahar_azadi": "1,944,500,000",
            "coin_nim_azadi": "1,024,200,000",
            "coin_rob_azadi": "564,900,000",
            "coin_gerami": "280,000,000"
        }
    }
}

تست زنده این سرویس

می‌خواهید عملکرد این متد را ببینید؟ وارد کنسول تست شوید و درخواست واقعی ارسال کنید.

اجرای درخواست در کنسول

تست تست سرویس API لایسنس دریافت لایسنس API