خلاصه در یک نگاه: API قیمت طلا یعنی سایت شما نرخ روز طلا و سکه را خودکار از یک سرویس قیمتدهی بگیرد و قیمت هر محصول را از روی وزن، عیار، اجرت، سود و مالیات حساب کند. برای گالریای که فروش آنلاین دارد، اتصال خودکار با امکان تأیید یا اصلاح نرخ توسط مدیر معمولاً امنترین راه است. سه چیز را قبل از اتصال روشن کنید: منبع اصلی و منبع پشتیبان نرخ، فاصله بهروزرسانی، و اینکه وقتی سرویس قطع شد سایت چه نشان بدهد.
- ویجت آماده فقط نرخ را نمایش میدهد؛ برای قیمتگذاری محصولات به داده خام (JSON) نیاز دارید.
- قیمت نهایی را روی سرور حساب کنید، نه در مرورگر مشتری.
- آخرین زمان بهروزرسانی نرخ را کنار قیمت نشان بدهید.
- قفل قیمت هنگام پرداخت، اختلاف چند دقیقهای نرخ را بیدردسر میکند.
مشتری طلا قبل از خرید معمولاً نرخ روز را در یک سایت خبری یا کانال قیمت دیده است. اگر سایت گالری شما عددی قدیمیتر نشان بدهد، دو حالت پیش میآید: یا مشتری فکر میکند گرانفروشی میکنید، یا ارزانتر از بازار میفروشید و ضررش را خودتان میدهید. به همین دلیل بیشتر گالریهایی که فروش آنلاین جدی دارند، دیر یا زود به سراغ API قیمت طلا میروند. در این مطلب توضیح میدهیم این اتصال دقیقاً چه کاری میکند، چه گزینههایی در ایران وجود دارد، قیمت محصول را چطور باید از روی نرخ حساب کرد و چه خطاهایی بیشتر از همه دردسر درست میکنند.
اگر هنوز سایت ندارید یا میخواهید کل امکانات یک سایت طلا را ببینید، اول راهنمای طراحی سایت طلا فروشی را بخوانید. این مطلب فقط روی بخش نرخ و محاسبه قیمت تمرکز دارد.

API قیمت طلا دقیقاً چیست و با ویجت قیمت چه فرقی دارد؟
API یک نشانی روی سرور سرویسدهنده است که سایت شما هر چند دقیقه یکبار از آن نرخها را میگیرد؛ معمولاً در قالب JSON و شامل نرخ گرم طلای ۱۸ عیار، مثقال، سکههای رایج و گاهی انس جهانی و ارز. سایت این عدد را ذخیره میکند و با آن قیمت محصولات را حساب میکند.
ویجت چیز دیگری است: یک جدول یا کادر آماده که روی صفحه شما نمایش داده میشود ولی عددش در اختیار سایت شما نیست. ویجت برای صفحه «قیمت روز» یا نوار بالای سایت خوب است، اما نمیتوانید با آن قیمت یک انگشتر ۴.۲ گرمی را حساب کنید. خیلی از گالریها همین دو را با هم اشتباه میگیرند و بعد میبینند قیمت محصولات هنوز دستی است.
| روش | چه کاری میکند | مناسب چه کسی | ریسک اصلی |
|---|---|---|---|
| ورود دستی نرخ در پنل | مدیر روزی یک یا چند بار نرخ را وارد میکند و همه قیمتها با هم عوض میشوند | سایت معرفی یا فروش کم | فراموش کردن در روزهای پرنوسان |
| ویجت آماده | فقط جدول نرخ را نمایش میدهد | صفحه قیمت روز و جذب بازدید | قیمت محصولات را عوض نمیکند |
| API خودکار | سایت نرخ را میگیرد و قیمتها را خودش حساب میکند | فروشگاه فعال با فروش روزانه | قطعی یا عدد اشتباه سرویس |
| ترکیبی (API با تأیید مدیر) | نرخ خودکار میآید، ولی اگر بیش از حد مجاز تغییر کرد، منتظر تأیید میماند | بیشتر گالریهای جدی | نیاز به تعریف درست سقف تغییر |
گزینههای دریافت نرخ طلا در ایران
در ایران چند سرویس شناختهشده نرخ طلا، سکه و ارز را منتشر میکنند. برای نمونه، شبکه اطلاعرسانی طلا و ارز (tgju) هم ویجت آماده و افزونه وردپرس برای نمایش جدول قیمت دارد و هم سرویس API برای دریافت داده. سرویسهای دیگری هم هستند که نرخ را بهصورت وبسرویس میفروشند. شرایط استفاده، سقف تعداد درخواست و هزینه این سرویسها مدام تغییر میکند؛ پس قبل از تصمیم، شرایط فعلی را از خود سرویس بگیرید و در قرارداد سایت هم بنویسید هزینه اشتراک سالانه با کیست.
چند نکته که در انتخاب سرویس به کار میآید:
- مجوز استفاده تجاری: نمایش یا استفاده از نرخ برای فروش باید طبق شرایط سرویس مجاز باشد. کپی کردن عدد از صفحه یک سایت دیگر با اسکریپت (اسکرپینگ) هم از نظر حقوقی و هم از نظر فنی شکننده است؛ با یک تغییر ظاهری در آن سایت، قیمتهای شما صفر یا غلط میشود.
- فاصله بهروزرسانی: برای فروشگاه، بهروزرسانی هر چند دقیقه معمولاً کافی است. لحظهای بودن واقعی بیشتر برای معاملهگرها مهم است تا خریدار انگشتر.
- کدام نرخ: نرخ گرم ۱۸ عیار، مثقال، طلای آبشده و سکه هرکدام جدا هستند. فرمول شما باید دقیقاً همان نرخی را بگیرد که در مغازه با آن فاکتور میزنید.
- منبع پشتیبان: اگر سرویس اصلی چند ساعت جواب نداد، سایت یا از منبع دوم بخواند یا با آخرین نرخ معتبر کار کند و فروش را محدود کند.
- پشتیبانی و پایداری: بپرسید اگر ساختار پاسخ عوض شد، چقدر زودتر خبر میدهند.
فرمول قیمت محصول از روی نرخ روز

نرخ روز فقط یکی از اجزای قیمت است. قیمت مصنوعات طلا معمولاً از این اجزا ساخته میشود: وزن ضرب در نرخ گرم، اجرت ساخت (درصدی یا ریالی)، سود فروشنده، و مالیات بر ارزش افزوده که روی اجرت و سود حساب میشود، نه روی خود طلا. سنگ و متعلقات هم اگر جدا قیمت دارند، جدا اضافه میشوند. فرمول دقیق و درصدهای مجاز را با اتحادیه و حسابدار خودتان چک کنید؛ نرخ مالیات هم هر سال در قانون بودجه مشخص میشود و نباید داخل کد ثابت نوشته شود.
مثال فرضی: یک دستبند ۵ گرمی ۱۸ عیار با اجرت ۱۲ درصد و سود ۷ درصد. سایت نرخ گرم را از API میگیرد، وزن ضرب در نرخ را حساب میکند، ۱۲ درصد اجرت و ۷ درصد سود را روی آن میگذارد، مالیات را فقط روی مجموع اجرت و سود حساب میکند و عدد نهایی را گرد میکند. اگر نرخ گرم در طول روز تغییر کند، همین محاسبه دوباره انجام میشود و قیمت همه محصولات با هم عوض میشود. این مثال برای توضیح روش است و درصدهای آن پیشنهاد ما نیست.
چند تصمیم که باید قبل از برنامهنویسی گرفته شود:
- اجرت هر محصول درصدی است یا ریالی، و آیا برای دستهها پیشفرض دارد؟
- سود فروشنده برای همه یکی است یا برای سکه، شمش و مصنوعات فرق میکند؟
- گرد کردن قیمت به چه رقمی انجام شود (مثلاً هزار تومان)؟
- محصولاتی که قیمت ثابت دارند (مثل نقره یا بدلیجات) از فرمول خارج باشند.
- تخفیف روی اجرت است یا روی کل قیمت؟ این دو عدد کاملاً متفاوت درمیآورند.
قفل قیمت، سبد خرید و لحظه پرداخت
سختترین قسمت کار، فاصله بین افزودن به سبد و پرداخت است. اگر نرخ در این چند دقیقه تغییر کند، چه اتفاقی بیفتد؟ سه رویکرد رایج داریم:
- قفل زمانی: وقتی مشتری وارد صفحه پرداخت شد، قیمت برای چند دقیقه ثابت میماند و زمان باقیمانده نشان داده میشود. بعد از آن، قیمت دوباره حساب میشود.
- محاسبه دوباره قبل از پرداخت: اگر اختلاف از یک سقف کوچک بیشتر بود، مشتری قیمت جدید را میبیند و دوباره تأیید میکند.
- پیشفاکتور و تماس: برای قطعههای سنگین یا سفارشی، سایت فقط ثبت سفارش میگیرد و قیمت قطعی تلفنی اعلام میشود.
هرکدام را انتخاب کنید، مبلغی که به درگاه پرداخت فرستاده میشود باید روی سرور و درست در همان لحظه ساخته شود. اگر قیمت در مرورگر حساب شود، با کمی دستکاری میشود عدد کمتری به درگاه فرستاد. جزئیات فنی اتصال درگاه را در مطلب اتصال درگاه پرداخت به سایت نوشتهایم.
اگر میخواهید بدانید برای گالری شما ویجت کافی است یا اتصال کامل لازم دارید، وضعیت فعلی سایت و تعداد محصولات را برایمان بفرستید. در یک تماس کوتاه میگوییم کدام راه بهصرفهتر است؛ تلفن ۰۹۹۱۵۶۱۵۹۴۶.
وقتی سرویس نرخ قطع شد یا عدد اشتباه داد
هر سرویسی ممکن است چند دقیقه یا چند ساعت جواب ندهد، یا بهخاطر خطا یک عدد عجیب برگرداند. سایت طلا باید برای این لحظه از قبل برنامه داشته باشد:
| اتفاق | رفتار درست سایت |
|---|---|
| سرویس جواب نمیدهد | آخرین نرخ معتبر با زمانش نمایش داده شود و اگر قدیمیتر از سقف تعیینشده بود، دکمه خرید به «استعلام قیمت» تبدیل شود |
| نرخ ناگهان چند درصد جابهجا شد | نرخ جدید در حالت انتظار بماند و به مدیر پیامک یا پیام بله برسد تا تأیید کند |
| عدد صفر یا خالی آمد | نادیده گرفته شود و خطا ثبت شود؛ هیچ قیمتی نباید صفر شود |
| ساختار پاسخ عوض شد | خواندن داده متوقف شود و هشدار برای پشتیبان برود |
این بخش را در قرارداد طراحی هم بنویسید: سقف تغییر مجاز، مدت اعتبار آخرین نرخ و اینکه هشدار به چه کسی برسد. اینها چیزهایی هستند که در دموی فروشنده معمولاً دیده نمیشوند، ولی در یک روز پرنوسان بازار، فرق بین سود و ضرر را تعیین میکنند.
نمایش قیمت روز در سایت برای اعتماد و سئو
جدا از قیمت محصولات، خیلی از گالریها یک صفحه «قیمت روز طلا و سکه» هم میسازند. این صفحه میتواند بازدید جستوجو بیاورد، به شرطی که فقط یک جدول خالی نباشد. چند پیشنهاد عملی:
- زمان آخرین بهروزرسانی را دقیق و با ساعت نشان بدهید.
- منبع نرخ را بنویسید؛ این کار شفافیت میسازد.
- کنار جدول، توضیح کوتاه بدهید که قیمت محصولات گالری با چه فرمولی از این نرخ ساخته میشود.
- ماشینحساب سادهای بگذارید که با وزن و اجرت، قیمت تقریبی را بدهد و مشتری را به محصولات یا تماس برساند.
- جدول را با HTML واقعی بسازید، نه عکس؛ موتور جستوجو عکس جدول را نمیخواند.
دقت کنید که اسکریپت دریافت نرخ صفحه را کند نکند. نرخ را روی سرور ذخیره کنید و صفحه را از همان نسخه ذخیرهشده بسازید؛ اینکه هر بازدیدکننده یک درخواست جدا به سرویس قیمت بفرستد، هم کند است و هم سقف درخواستهای اشتراک را زود پر میکند.
اتصال نرخ سایت با نرمافزار مغازه

اگر در مغازه نرمافزار طلافروشی دارید، بهتر است نرخ سایت و نرخ مغازه از یک جا بیایند؛ وگرنه مشتریای که سایت را دیده و به مغازه آمده، با عدد دیگری روبهرو میشود. دو مدل رایج داریم: نرمافزار مغازه نرخ را تعیین میکند و سایت از آن میخواند، یا هر دو از یک API مشترک میخوانند. انتخاب بین این دو به این بستگی دارد که نرمافزار شما خروجی یا وبسرویس داشته باشد. درباره امکانات نرمافزار داخلی مغازه، مطلب نرم افزار طلافروشی را ببینید.
موجودی هم همینطور است. قطعهای که امروز در مغازه فروخته شد، نباید فردا در سایت قابل خرید باشد. حداقل کار این است که کد یا بارکد هر قطعه در هر دو سیستم یکی باشد تا هماهنگی ممکن شود.
هزینه و زمان اتصال API قیمت طلا
هزینه این کار سه بخش جدا دارد: اشتراک سرویس نرخ (که با خود سرویس توافق میکنید)، برنامهنویسی اتصال و فرمول قیمت، و نگهداری. اگر سایت روی وردپرس و ووکامرس است، افزونههای آمادهای وجود دارند که نرخ را میگیرند و قیمت را با وزن و اجرت حساب میکنند؛ این راه ارزانتر است ولی باید ببینید فرمول افزونه دقیقاً همان فرمول شماست یا نه. برای سایت اختصاصی، اتصال یک سرویس با فرمول قیمت، قفل قیمت و رفتار هنگام قطعی معمولاً جزو کار طراحی سایت دیده میشود و چند روز تا دو هفته کار میبرد، بسته به اینکه هماهنگی با نرمافزار مغازه هم بخواهید یا نه. برای اینکه بدانید اجزای هزینه یک اتصال API چطور حساب میشود، مطلب هزینه طراحی API را بخوانید و برای دیدن پلنهای طراحی سایت به صفحه تعرفهها سر بزنید.
اشتباههای رایج
- استفاده از ویجت به جای داده خام و دستی ماندن قیمت محصولات.
- کپی کردن نرخ از سایت دیگر با اسکریپت، بدون مجوز و بدون منبع پشتیبان.
- حساب کردن قیمت در مرورگر و فرستادن همان عدد به درگاه.
- نشان ندادن زمان آخرین بهروزرسانی نرخ.
- ثابت نوشتن درصد مالیات و سود داخل کد.
- تعریف نکردن سقف تغییر و تأیید مدیر برای روزهای پرنوسان.
- جدا بودن نرخ سایت و نرخ مغازه.
چکلیست قبل از قرارداد اتصال
- منبع اصلی نرخ و شرایط استفاده تجاری آن مشخص است
- منبع پشتیبان یا رفتار هنگام قطعی تعریف شده است
- نوع نرخ (گرم ۱۸، مثقال، سکه، آبشده) با فاکتور مغازه یکی است
- فرمول اجرت، سود، سنگ و مالیات نوشته و با یک فاکتور واقعی تست شده است
- گرد کردن قیمت و تخفیف قانون روشن دارد
- قفل قیمت در صفحه پرداخت و مدت آن تعیین شده است
- مبلغ درگاه روی سرور ساخته میشود
- سقف تغییر نرخ و هشدار به مدیر فعال است
- زمان آخرین بهروزرسانی کنار قیمت دیده میشود
- هزینه اشتراک سالانه سرویس و مسئول تمدید آن مشخص است
سؤالهای رایج
API قیمت طلا رایگان هست؟
بعضی سرویسها ویجت یا افزونه نمایشی رایگان دارند، ولی دریافت داده خام برای استفاده تجاری معمولاً اشتراک دارد یا محدودیت تعداد درخواست. شرایط هر سرویس را جدا بپرسید و آن را در هزینه سالانه سایت حساب کنید.
قیمت محصولات سایت طلا هر چند وقت باید عوض شود؟
برای بیشتر گالریها، بهروزرسانی هر چند دقیقه کافی است. مهمتر از سرعت، این است که زمان آخرین بهروزرسانی دیده شود و در لحظه پرداخت قیمت دوباره چک شود.
وردپرس هم میتواند قیمت را خودکار حساب کند؟
بله، با افزونههای قیمتگذاری طلا یا کدنویسی سفارشی. قبل از نصب، یک فاکتور واقعی مغازه را با افزونه حساب کنید؛ اگر عدد با فاکتور شما یکی نبود، افزونه به کارتان نمیآید.
اگر سرویس نرخ قطع شود، فروش سایت متوقف میشود؟
نباید بهطور کامل متوقف شود. سایت تا مدت مشخصی با آخرین نرخ معتبر کار میکند و بعد از آن، دکمه خرید به استعلام قیمت تبدیل میشود تا فروش با نرخ قدیمی انجام نشود.
میشود قیمت سکه و شمش را هم از همین API گرفت؟
معمولاً بله، ولی سکه و شمش فرمول جدا دارند و اجرت مصنوعات به آنها تعلق نمیگیرد. برای هر نوع کالا فرمول جدا تعریف کنید و فروش طلای آبشده یا شمش را قبل از راهاندازی از نظر مجوز بررسی کنید.
چطور شرکت مناسب برای این کار پیدا کنم؟
از شرکت بخواهید یک نمونه سایت طلا با قیمت خودکار نشان بدهد و رفتار سایت هنگام قطعی سرویس را توضیح دهد. ملاکهای انتخاب را در فهرست بهترین شرکت طراحی سایت طلا فروشی جمع کردهایم.
مطالب مرتبط
- طراحی سایت طلا فروشی؛ همه امکانات یک سایت گالری طلا
- نرم افزار طلافروشی؛ حساب وزنی، ترازو و فاکتور مغازه
- API چیست؛ اگر میخواهید اصل ماجرا را ساده بفهمید
- بهترین شرکت طراحی سایت؛ ملاکهای انتخاب طراح در ۱۴۰۵
اتصال API قیمت طلا با پونوکد
ما در پونوکد سایت طلا را با نرخ خودکار، فرمول قیمت مغازه، قفل قیمت هنگام پرداخت و رفتار درست در قطعی سرویس میسازیم. اگر سایت فعلی دارید و فقط میخواهید قیمتها خودکار شود، همان را بررسی میکنیم و اگر یک افزونه آماده برایتان کافی باشد، صادقانه همین را میگوییم. بگویید سایت روی چه بستری است، چند محصول دارید و فاکتور مغازه را با چه فرمولی میزنید. فهرست کارهای ما در صفحه خدمات است و جزئیات طراحی در صفحه طراحی سایت.
تلفن: ۰۹۹۱۵۶۱۵۹۴۶، تلگرام: https://t.me/resonea، یا از فرم تماس پیام بگذارید.



