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

تغییرات محصول

تاریخچهٔ انتشار سرویکس

انتشارهای تأییدشدهٔ سرویکس را همراه با وضعیت سازگاری و اقدام لازم دنبال کنید؛ از شروع رایگان و افزونهٔ وردپرس تا پوشش نمادها و راهنماهای فنی.

این صفحه فقط تغییرهایی را ثبت می‌کند که انتشارشان با کد و مستندات، فرادادهٔ عمومی یا تیکت تکمیل‌شده قابل اثبات باشد. تاریخ هر بخش، زمان در دسترس قرار گرفتن همان تغییر است؛ نه زمان شروع توسعه. کاری که هنوز در حال بررسی است به‌عنوان قابلیت منتشرشده معرفی نمی‌شود. کنار هر مورد نیز سازگاری و اقدام احتمالی مشتری آمده است.

۲۱ شهریور ۱۴۰۵ — آمار مدیریتی استفاده از کاوشگر بازار

بهبود سازگار گزارش مدیریتی؛ رفتار کاوشگر بازار برای مشتری، پاسخ احرازشدهٔ قیمت، خروجی‌ها و سهمیه‌ها تغییری نکرده است. مدیران مجاز اکنون می‌توانند روند کلی استفاده از کاوشگر را بررسی کنند و برای هر کاربر، نمایی امن و حریم‌خصوصی‌محور از فعالیت ثبت‌شده ببینند.

  • داشبورد کلی تعداد جدول‌های ساخته‌شده، اقدام‌های ثبت‌شده برای خروجی Excel و JSON، استفادهٔ تکراری، توزیع تعداد دارایی درخواستی و تازگی تحویل رویدادها را گزارش می‌کند.
  • زبانهٔ فعالیت کاربر دارای انتخاب بازه، نمودار زمانی، خلاصهٔ معیارها و فهرست صفحه‌بندی‌شدهٔ اقدام‌های اخیر است.
  • این گزارش به‌طور هدفمند قیمت بازار، هویت دارایی‌های انتخاب‌شده، اطلاعات محرمانه، دادهٔ تکرارنشدن درخواست و خطاهای داخلی تحویل را نمایش نمی‌دهد.
  • اقدام لازم برای مشتری: هیچ اقدامی لازم نیست. این قابلیت فقط در اختیار مدیران مجاز است.

۲۱ شهریور ۱۴۰۵ — فهرست کامل نمادها در کاوشگر داده بازار

بهبود سازگار پنل مشتری؛ پاسخ قیمت احرازشده، خروجی JSON و قوانین سهمیه تغییری نکرده است. کاوشگر اکنون به‌جای فهرست جداگانهٔ نمودارها، از فهرست اختصاصی قیمت‌های جاری استفاده می‌کند.

  • هر ۱۷۱ نماد پشتیبانی‌شده در دسته‌های ارز، رمزارز، طلا، سکه، فلزات گران‌بها و شاخص بورس در دسترس است.
  • انتخاب‌های مدیر برای نمودار و موجود بودن تاریخچهٔ OHLC دیگر نمادی را از کاوشگر پنهان نمی‌کند.
  • در فهرست انتخاب، جدول ساخته‌شده و فایل Excel نام کوتاه نماد کنار واحدی جداگانه نمایش داده می‌شود تا بررسی و فیلتر کردن جفت‌ها ساده‌تر باشد.
  • اقدام لازم: هیچ اقدامی لازم نیست. برای استفاده از فهرست کامل، کاوشگر احرازشده را باز کنید.

۲۰ شهریور ۱۴۰۵ — بازنویسی روان صفحات فارسی کاوشگر داده بازار

بهبود مستندات؛ عملکرد کاوشگر، قراردادهای API احرازشده و قوانین سهمیه تغییری نکرده است. متن فارسی صفحه معرفی و راهنمای کاوشگر از ابتدا تا انتها با نثری طبیعی‌تر و امروزی‌تر بازنویسی شده است.

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

۲۰ شهریور ۱۴۰۵ — نمایش خواناتر و هم‌تراز قیمت‌ها در کاوشگر بازار

بهبود نمایش برای مشتری؛ مقدارهای API احرازشده و روش محاسبهٔ سهمیه تغییری نکرده است. جدول‌های ساخته‌شده در کاوشگر اکنون ستون‌های هم‌تراز و دقت نمایشی کوتاه و متناسب با هر نماد دارند.

  • عددهای فارسی با رقم فارسی، فاصلهٔ باریک میان گروه‌های سه‌رقمی و ممیز فارسی نمایش داده می‌شوند و عددهای انگلیسی نشانه‌گذاری آشنای خود را نگه می‌دارند.
  • کد و مقدار هر نماد از جهت نوشتار پیرامون جدا شده‌اند تا ترکیب متن فارسی و انگلیسی خوانا بماند.
  • مقدارهای بسیار کوچک و ناصفر همچنان از صفر قابل تشخیص‌اند.
  • کاربر می‌تواند مقدار دقیق منبع را با دکمهٔ دسترس‌پذیر هر ردیف کپی کند؛ مرتب‌سازی و خروجی‌ها نیز همچنان از همان مقدار دقیق و بدون تغییر استفاده می‌کنند.
  • اقدام لازم: هیچ اقدامی لازم نیست. برای دیدن نمایش تازه، یک جدول احرازشده بسازید.

۲۰ شهریور ۱۴۰۵ — انتخاب سریع‌تر نمادها با دسته‌بندی‌های بازشونده

بهبود تجربهٔ کاربری؛ API احرازشده و روش محاسبهٔ سهمیه تغییری نکرده است. نمادهای کاوشگر داده بازار اکنون در دسته‌های ارز، رمزارز، طلا، سکه، فلزات گران‌بها و شاخص بورس مرتب شده‌اند.

  • همهٔ دسته‌ها در آغاز بسته‌اند و با بازکردن یک دسته، دستهٔ قبلی بسته می‌شود.
  • عنوان هر دسته تعداد نمادهای در دسترس و انتخاب‌شده را نشان می‌دهد؛ دکمه‌های هر دسته نیز فقط نتیجه‌های نمایان را انتخاب یا انتخاب‌های همان دسته را پاک می‌کنند.
  • جست‌وجوی سراسری نام فارسی و انگلیسی و کد پایدار نماد را بررسی می‌کند، نخستین دستهٔ هماهنگ را باز می‌کند و انتخاب‌های قبلی را نگه می‌دارد.
  • فهرست فشردهٔ مرور انتخاب‌ها، بررسی یا حذف نمادها را بدون پرکردن صفحه از برچسب‌های فراوان ممکن می‌کند.
  • مرور، جست‌وجو و انتخاب نمادها همچنان هیچ قیمتی دریافت نمی‌کند، دورهٔ آزمایشی را آغاز نمی‌کند و از سهمیه کم نمی‌کند.
  • اقدام لازم: هیچ اقدامی لازم نیست. برای انتخاب نمادها، یک دسته را در کاوشگر داده بازار باز کنید.

۲۰ شهریور ۱۴۰۵ — خروجی Excel خواناتر و قابل فیلتر در کاوشگر داده بازار

اصلاح قابل‌مشاهده برای مشتری؛ پاسخ JSON احرازشده تغییری نکرده است. فایل Excel اکنون بدون پیام ترمیم باز می‌شود و داده‌ها را در دو برگهٔ «قیمت‌ها» و «دادهٔ خام» ارائه می‌کند.

  • برگهٔ قیمت‌ها ستون دسته‌بندی فارسی دارد و همهٔ ستون‌های نمایان آن قابل فیلتر هستند.
  • قالب عددها با جداکنندهٔ هزارگان و در صورت نیاز نمایش علمی خواناتر شده است؛ متن دقیق مقدار و کد ثابت دسته‌بندی نیز در برگهٔ دادهٔ خام باقی می‌ماند.
  • سرستون هر دو برگه هنگام پیمایش ثابت می‌ماند و جهت برگه با زبان فارسی یا انگلیسی هماهنگ است.
  • فایل همچنان از جدول بارگذاری‌شده در مرورگر ساخته می‌شود؛ بنابراین درخواست قیمت تازه‌ای نمی‌فرستد، سهمیه مصرف نمی‌کند و روی سرور ذخیره نمی‌شود.
  • اقدام لازم: اقدامی لازم نیست. برای دریافت قالب اصلاح‌شده، فایل را دوباره دانلود کنید.

۲۰ شهریور ۱۴۰۵ — انتخاب ایمن‌تر و خروجی دقیق‌تر Excel در کاوشگر داده بازار

اصلاح قابل‌مشاهده برای مشتری؛ ساختار پاسخ احرازشده و فایل‌های خروجی با نسخه قبل سازگار مانده‌اند. سقف انتخاب پیش از کم‌شدن سهمیه بررسی می‌شود و مقدارهای اعشاری بسیار کوچک در فایل Excel دقیق و خوانا می‌مانند.

  • انتخاب نمادهای نمایان روی ۱۰۰ نماد متوقف می‌شود و پیش از تأیید، دلیل این محدودیت را روشن می‌کند.
  • درخواست نامعتبر، تکراری، ناشناخته یا بیش از حد مجاز، بدون مصرف سهمیه رد می‌شود.
  • اگر Excel نتواند یک مقدار اعشاری را به‌شکل عدد دقیق نشان دهد، مقدار به‌صورت متن دقیق و ایمن از فرمول ذخیره می‌شود تا صفر دیده نشود.
  • مسیرهای انگلیسی کاوشگر، قیمت‌گذاری، ثبت‌نام و مستندات از این پس زبان انتخاب‌شده را حفظ می‌کنند.
  • اقدام لازم: هیچ اقدامی لازم نیست. معرفی کاوشگر یا راهنمای مشتری را ببینید.

۲۰ شهریور ۱۴۰۵ — ثبت پایدار مصرف در کاوشگر داده بازار

اصلاح پایداری؛ ساختار پاسخ احرازشده و فایل‌های خروجی با نسخه قبل سازگار است. ساخت موفق جدول و دریافت Excel یا JSON حالا پیش از اعلام موفقیت، به‌شکل پایدار ثبت می‌شود. اگر انتقال داده آماری موقتاً در دسترس نباشد، رکوردهای معطل بدون ثبت تکراری دوباره پردازش می‌شوند.

  • اگر اعتبار پلن یا دوره آزمایشی هنگام دریافت داده تمام شود، درخواستی که پیش‌تر پذیرفته شده دیگر فقط به‌دلیل ثبت آمار با خطا روبه‌رو نمی‌شود.
  • دانلود فایل تنها پس از ثبت رکورد مصرفِ بدون مقدار بازار آغاز می‌شود.
  • هیچ قیمت بازار یا فایل ساخته‌شده‌ای در صف پایدار نگهداری نمی‌شود و مقدار سهمیه نیز تغییری نکرده است.
  • اقدام لازم: هیچ اقدامی لازم نیست. معرفی کاوشگر یا راهنمای مشتری را ببینید.

۲۰ شهریور ۱۴۰۵ — معرفی و راهنمای عمومی کاوشگر داده بازار

انتشار مستندات عمومی؛ API احرازشده با اتصال‌های قبلی سازگار می‌ماند. معرفی دوزبانه و راهنمای گام‌به‌گام کاوشگر داده بازار منتشر شد. این صفحه‌ها حالت اولیه بدون درخواست، تأیید روشن مصرف یک واحد سهمیه، فیلدهای جدول، دوره هفت‌روزه کاوشگر برای شروع رایگان و خروجی Excel و JSON در مرورگر را توضیح می‌دهند.

  • کاوشگر همچنان به ورود نیاز دارد و هیچ مقدار بازارِ ماشین‌خوانی را در اختیار بازدیدکننده ناشناس نمی‌گذارد.
  • گرفتن خروجی از نتیجه بارگذاری‌شده، درخواست دوباره‌ای نمی‌فرستد، سهمیه دیگری مصرف نمی‌کند و در حالت عادی فایلی روی سرور سرویکس نگه نمی‌دارد.
  • دسترسی دائمی API در شروع رایگان از دوره هفت‌روزه کاوشگر جداست.
  • اقدام لازم: اتصال‌های فعلی نیازی به تغییر ندارند. پیش از کار با پنل، معرفی کاوشگر یا راهنمای مشتری را بخوانید.

۶ شهریور ۱۴۰۵ — راهنمای امن ساخت نمودار OHLC

مستندات تازه؛ اتصال‌های قبلی همچنان سازگارند. راهنمای دوزبانهٔ جدید توضیح می‌دهد چطور با مسیر احرازشدهٔ OHLC سرویکس یک نمودار کندلی واقعی بسازید و API Key را فقط در بک‌اند خودتان نگه دارید.

  • بازه‌های 15m، 1h، 4h و 1d، مرز تاریخچهٔ قابل اتکای هر نماد، کندل‌های UTC با بازهٔ نیمه‌باز، فاصله‌های خالی، اصلاح داده، کندل در حال تشکیل، دقت، محدودیت بازه، خطاها و سهمیه در این راهنما آمده‌اند.
  • نمونه‌های بررسی‌شدهٔ cURL، Node و TypeScript و Lightweight Charts نسخهٔ ۵، اعتبارسنجی، سقف تلاش دوباره، حافظهٔ موقت محدود، تغییر بازه، به‌روزرسانی آخرین کندل، پاک‌سازی منابع مرورگر و درج منبع را نشان می‌دهند. نمونه‌های عمومی فقط جای‌خالی دارند.
  • اقدام لازم: برای ساخت نمودار جدید، راهنمای ساخت نمودار OHLC را دنبال کنید. API Key را روی سرور نگه دارید و تاریخچه را از مرز اعلام‌شدهٔ همان نماد بخواهید.

۵ شهریور ۱۴۰۵ — تاریخچهٔ احرازشدهٔ OHLC با مرز قابل اتکا

تغییر افزایشی در /api/v1؛ اتصال‌های قبلی همچنان سازگارند. مشتری دارای کلید API می‌تواند کندل‌های OHLC نمادهای پشتیبانی‌شده را با بازه‌های 15m، 1h، 4h و 1d دریافت کند. کاتالوگ احرازشده نیز برای هر نماد، وجود تاریخچهٔ قابل اتکا و زمان نخستین مشاهدهٔ قابل استفاده را اعلام می‌کند.

  • کندل‌ها با زمان UTC و ترتیب صعودی برمی‌گردند، بازهٔ خالی ساخته نمی‌شود، دقت اعشاری حفظ می‌شود و کندل در حال تشکیل با وضعیت ناکامل مشخص است.
  • هر درخواست یک واحد عادی از سهمیهٔ دارایی مصرف می‌کند. اگر شروع بازه پیش از مرز قابل اتکای نماد باشد، همان مرز در خطای ساختاریافته برمی‌گردد.
  • اقدام لازم: اتصال‌های فعلی نیازی به تغییر ندارند. اتصال نمودار تازه باید پیش از درخواست تاریخچه، ohlcAvailable و ohlcAvailableFrom را از کاتالوگ احرازشده بخواند.

۲ شهریور ۱۴۰۵ — توضیح یکدست شروع رایگان و پیش‌نمایش پایدارتر بازار

اصلاح تجربهٔ کاربر؛ ساختار API احرازشده با اتصال‌های قبلی سازگار می‌ماند. توضیح‌های شروع رایگان در سایت و مستندات هماهنگ شده‌اند. نمونه‌های پاسخ واقعی اکنون quoteUnit را هم نشان می‌دهند و اگر تازه‌سازی بازار ردیفی برنگرداند، آخرین تصویر معتبر جای خود را به تصویر خالی نمی‌دهد.

  • برای شروع رایگان دائمی، همان ثبت‌نام کافی است: روزانه ۵۰ درخواست احرازشده، یک کلید API فعال و دسترسی به همهٔ اندپوینت‌های مستند؛ بدون فعال‌سازی دورهٔ آزمایشی، اطلاعات پرداخت یا تاریخ انقضا.
  • واحد ریال، تومان، دلار یا شاخص را از روی کد نماد حدس نزنید و در برنامه مستقیماً مقدار quoteUnit پاسخ را نمایش دهید.
  • تازه‌سازی ناموفق و بدون ردیف، دیگر تصویر معتبر قبلی بازار را کنار نمی‌زند. زمان تازگی همچنان مشخص است تا تصویر قدیمی به‌جای قیمت تازه معرفی نشود.
  • اقدام لازم: اتصال‌های فعلی به تغییر ساختار نیاز ندارند؛ فقط مطمئن شوید واحد از quoteUnit خوانده می‌شود. جزئیات شروع رایگان و قرارداد قیمت جاری را ببینید.

۳۱ مرداد ۱۴۰۵ — پوشش گسترده‌تر رمزارز و افزایش سقف دریافت گروهی

تغییر افزایشی در /api/v1؛ اتصال‌های قبلی همچنان سازگارند. کاتالوگ احرازشده به ۴۸ رمزارز پایه گسترش یافت و برای هرکدام دو نماد مستقل با واحدهای USD و RLS ارائه شد. سقف دریافت قیمت‌های انتخابی نیز از ۲۰ به ۱۰۰ کد نماد متمایز رسید.

  • به‌جای نگهداری یک فهرست ثابت، کدها و واحدها را از baseCode، category و quoteUnit کاتالوگ بخوانید.
  • اگر پارامتر codes را نفرستید، پاسخ کامل قیمت‌های جاری مثل قبل برمی‌گردد و نیازی به تغییر اتصال فعلی نیست.
  • فهرست نمادهای پشتیبانی‌شده و قرارداد قیمت جاری را ببینید.

۳۱ مرداد ۱۴۰۵ — نمونهٔ اجرایی Vue 3 و Pinia

انتشار مستندات؛ بدون تغییر قرارداد API. راهنمای دوزبانهٔ Vue 3، Pinia و Composition API همراه با مخزن عمومی و مستقل نمونه منتشر شد. در این پروژه، کلید سرویکس پشت بک‌اند هم‌مبدأ می‌ماند، پاسخ واقعی سرویس اعتبارسنجی می‌شود، کش مشترک و محدود است و وضعیت‌های بارگذاری، پایان سهمیه، پاسخ خالی و خطا جداگانه مدیریت می‌شوند.

اقدام لازم: اتصال‌های فعلی نیازی به تغییر ندارند. برای ساخت برنامهٔ مرورگری می‌توانید از راهنمای تست‌شدهٔ Vue و Pinia الگو بگیرید.

۲۹ مرداد ۱۴۰۵ — انتشار Servix Market Data 1.2.1 در WordPress.org

انتشار افزونهٔ وردپرس؛ بدون تغییر قرارداد API. نسخهٔ 1.2.1 افزونهٔ Servix Market Data در مخزن رسمی WordPress.org در دسترس قرار گرفت. افزونه بلوک گوتنبرگ و شورت‌کد دارد، کلید API و کش را در سمت سرور نگه می‌دارد، نمایش فارسی و انگلیسی ارائه می‌کند و با شروع رایگان کار می‌کند.

۲۳ مرداد ۱۴۰۵ — تغییر قابل پیش‌بینی پلن اشتراک

تغییر در حساب و پرداخت؛ بدون تغییر قرارداد API. پیش از پرداخت، صفحهٔ تسویه‌حساب نتیجهٔ دقیق تمدید، ارتقا، کاهش سطح یا خرید نخستین پلن پولی را نشان می‌دهد. خرید پلنی با همان سهمیه، مدت فعلی را بیشتر می‌کند؛ ارتقا پس از پرداخت موفق اعمال می‌شود و کاهش سطح تا پایان سهمیهٔ بالاتر فعلی منتظر می‌ماند.

اقدام لازم: پیش از پرداخت، خلاصهٔ تغییر پلن را بخوانید. کلیدهای API فعلی معتبر می‌مانند. جزئیات در راهنمای تغییر پلن اشتراک آمده است.

۲۰ مرداد ۱۴۰۵ — دریافت قیمت چند نماد با یک درخواست

تغییر افزایشی در /api/v1؛ اتصال‌های قبلی همچنان سازگارند. پارامتر اختیاری codes به GET /api/v1/assets اضافه شد تا چند نماد انتخابی با یک فراخوانی احرازشده و یک واحد مصرف سهمیه دریافت شوند. ترتیب درخواست حفظ می‌شود، کد تکراری حذف می‌شود و با نفرستادن پارامتر، همان پاسخ کامل قبلی را می‌گیرید.

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

۱۸ مرداد ۱۴۰۵ — شروع رایگان دائمی

راه‌اندازی دسترسی رایگان؛ بدون تغییر ناسازگار در API. از این تاریخ، هر ثبت‌نام به‌صورت خودکار شروع رایگان دائمی دارد: روزانه ۵۰ درخواست احرازشده، یک کلید API فعال و دسترسی به همهٔ مسیرهای مستند. سفارش، اطلاعات پرداخت، فعال‌سازی جداگانهٔ دورهٔ آزمایشی یا تاریخ انقضا در کار نیست.

  • پلن پولی فقط سهمیه را برای مدت خرید افزایش می‌دهد و پس از پایان آن، حساب خودکار به شروع رایگان برمی‌گردد.
  • افزونهٔ رسمی وردپرس با شروع رایگان کار می‌کند.
  • اقدام لازم: حساب بسازید و کلید API را در پروفایل ایجاد کنید. جزئیات شروع رایگان را بخوانید.

۱۲ مرداد ۱۴۰۵ — راهنماهای Spring Boot و PHP

انتشار مستندات؛ بدون تغییر قرارداد API. راهنماهای دوزبانه و تست‌شدهٔ Spring Boot و PHP منتشر شدند. نگهداری کلید در سرور، اعتبارسنجی پاسخ، تلاش دوبارهٔ محدود، کش مشترک، سنجش تازگی و مدیریت امن خطا در این نمونه‌ها پوشش داده شده است.

اقدام لازم: هیچ. راهنمای متناسب با بک‌اند خود را انتخاب کنید و کلید API را وارد کد مرورگر نکنید.

۷ مرداد ۱۴۰۵ — راهنمای Python و سیاست چرخهٔ عمر API

انتشار مستندات؛ بدون تغییر قرارداد API. راهنمای دوزبانه و تست‌شدهٔ Python منتشر شد. همچنین سازگاری /api/v1، تعریف تغییر ناسازگار، رویهٔ اطلاع‌رسانی ۹۰روزه برای منسوخ‌سازی، استثناهای فوری، کانال‌های اعلان و مالک سیاست به‌روشنی مستند شدند.

اقدام لازم: هیچ. پیش از طراحی یک اتصال بلندمدت، سیاست چرخهٔ عمر API را مرور کنید.

روش نگهداری این تاریخچه

هر مورد فقط زمانی منتشر می‌شود که تاریخ و رفتار آن پشتوانهٔ قابل بررسی داشته باشد. در تغییرهای بعدی نیز نسخه یا مسیر تحت تأثیر، وضعیت سازگاری، اقدام لازم و لینک راهنمای مهاجرت یا رخداد ذکر خواهد شد. کار در حال توسعه یا بازبینی، انتشار قطعی محسوب نمی‌شود.

بازبینی شواهد: ۲ شهریور ۱۴۰۵. مالک: تیم محصول API سرویکس.

مسیرهای مرتبط

راهنماها و وضعیت سرویس