API رایگان نرخ ارز برای ووکامرس؛ آیا برای Tomanify لازم است چیزی بخرید؟

در خیلی از فروشگاه‌ها پاسخ کوتاه این است: نه. شما می‌توانید با یک فید JSON رایگان بازار آزاد شروع کنید و فقط اگر کسب‌وکارتان به نوسان‌های بسیار کوچک حساس است، بعداً به سراغ API اختصاصی‌تر بروید.

نمونه اختیاری JSON برای شروع

این نمونه صرفاً برای راهنمایی است؛ افزونه آن را پیش‌فرض یا خودکار وارد نمی‌کند. اگر می‌خواهید از آن استفاده کنید، خودتان آن را در تب Sources و فیلد JSON وارد کنید:

https://raw.githubusercontent.com/rate-json/default/main/data.json

برای اکثر فروشگاه‌ها، استفاده از یک نمونه JSON سازگار می‌تواند سریع‌ترین راه شروع باشد و نیاز شما را به خرید API جداگانه از سرویس‌دهنده‌های دیگر از بین می‌برد.

اگر فروشگاه شما حساس است

اگر نوسان‌های خیلی کوچک هم برایتان مهم است، دو راه دارید:

  1. از همین منبع رایگان استفاده کنید ولی Margin محافظه‌کارانه بگذارید.
  2. از API شخصی یا سفارشی استفاده کنید که نرخ را با بروزرسانی سریع‌تر در اختیارتان بگذارد.

ساختار JSON سازگار با Tomanify

اگر از یک برنامه‌نویس می‌خواهید برایتان API بسازد یا می‌خواهید از یک سرویس دیگر استفاده کنید، ساده‌ترین فرمتی که باید بخواهید این است:

{"values":{"USD":65000,"EUR":71000,"AED":17800,"TRY":2300,"CNY":9000}}

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

این منبع رایگان چه مزیتی دارد؟

راه‌اندازی سریع، نداشتن هزینهٔ اشتراک ماهانه، و قابل استفاده بودن برای بیشتر فروشگاه‌های ایرانی. همچنین برای رعایت امنیت و الزامات وردپرس، افزونه هیچ URL آماده‌ای را به‌صورت پیش‌فرض داخل تنظیمات پر نمی‌کند و این تصمیم را به مدیر سایت می‌سپارد.

محدودیت واقعی چیست؟

مهم‌ترین محدودیت این است که منبع رایگان لزوماً «لحظه‌ایِ ثانیه‌به‌ثانیه» نیست. برای بیشتر فروشگاه‌ها این مسئله با Cron مناسب و Margin معقول قابل پوشش است؛ اما برای قیمت‌گذاری بسیار رقابتی یا کالاهای بسیار حساس، API اختصاصی‌تر انتخاب حرفه‌ای‌تری است.

پیشنهاد عملی برای کاهش ریسک

  • JSON بازار آزاد را به‌عنوان منبع اصلی تنظیم کنید.
  • فیدهای بانک مرکزی را هم در Sources وارد کنید.
  • Source Mode و Cron را طوری تنظیم کنید که فقط به یک منبع وابسته نباشید.
  • برای پوشش تأخیر احتمالی، Margin محافظه‌کارانه بگذارید.

تصویر: محل ورود لینک در Sources

Sources tab
جایی که مدیر سایت URL JSON انتخابی خودش را در تب Sources وارد می‌کند

سوالات متداول این صفحه

جواب کوتاه به سوال‌هایی که معمولاً قبل از نصب، هنگام تنظیمات، یا زمان عیب‌یابی پیش می‌آید.

آیا برای استفاده از Tomanify حتماً باید API پولی بخرم؟

برای اکثر فروشگاه‌ها خیر. می‌توانید با منبع رایگان بازار آزاد شروع کنید و در صورت حساس بودن کسب‌وکار، Margin یا API شخصی‌تر در نظر بگیرید.

نمونه اختیاری JSON کجاست؟

نمونهٔ این صفحه فقط یک مثال اختیاری و مستنداتی است. افزونه هیچ URL آماده‌ای را پیش‌فرض وارد نمی‌کند؛ هر API شخصی دیگری هم اگر ساختار سازگار داشته باشد قابل استفاده است.

فرمت JSON سازگار با افزونه چیست؟

ساده‌ترین فرمت مستند و سازگار این است که کلید values داشته باشد و ارزها را با مقادیر عددیِ تومان برگرداند؛ مثلاً USD، EUR، AED، TRY و CNY.

این منبع رایگان همیشه لحظه‌ای است؟

منبع رایگان برای اکثر فروشگاه‌ها کافی است، اما اگر روی نوسان‌های خیلی کوچک حساس هستید، باید احتمال تأخیر بروزرسانی را در نظر بگیرید و با Margin یا API اختصاصی جبران کنید.

اگر JSON در دسترس نبود چه کنم؟

فیدهای بانک مرکزی را هم به‌عنوان پشتیبان تنظیم کنید و Source Mode را طوری بچینید که فقط به یک منبع وابسته نباشید.

اگر از API شخصی استفاده کنم چه چیزی باید به توسعه‌دهنده بگویم؟

به او بگویید خروجی را به ساختار JSON سازگار با Tomanify و مقادیر تومانِ بدون ویرگول تبدیل کند و لینک را با HTTPS در اختیار شما بگذارد.