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