• مدیر سایت
• آگوست 11, 2019

وب سرویس بازار بورس تهران؛ راهنمای جامع دریافت داده‌های مالی

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

چرا به وب سرویس بازار بورس تهران نیاز داریم؟

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

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

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

این وب سرویس برای طیف وسیعی از فعالان بازار سرمایه کاربرد دارد. مهم‌ترین کاربردها شامل موارد زیر است:

• 📊 ساخت برنامه‌های تحلیل تکنیکال: شما می‌توانید نمودارهای قیمت را به صورت خودکار طراحی کنید.
• 🤖 طراحی ربات‌های معامله‌گر: این وب سرویس به شما کمک می‌کند تا تصمیمات خرید و فروش را خودکار کنید.
• 📱 توسعه اپلیکیشن‌های موبایل: برنامه‌نویسان می‌توانند قیمت‌های لحظه‌ای را به کاربران اپلیکیشن خود نمایش دهند.

مزایای استفاده از وب سرویس بورس

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

• ⚡ سرعت بالا در انتقال داده: معماری RESTful این سرویس سرعت پاسخ‌گویی را به شدت افزایش می‌دهد.
• 📁 ارائه داده با فرمت استاندارد: قالب خروجی داده‌ها به صورت JSON است و خوانایی بالایی دارد.
• 🔄 امکان دریافت بهینه تغییرات: این سیستم با استفاده از شناسه نسخه، فقط تغییرات جدید را ارسال می‌کند.

راهنمای ثبت‌نام در وب سرویس بازار بورس تهران

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

• 🌐 ورود به سامانه: ابتدا وارد سایت ثبت‌نام به آدرس p.api.ir شوید.
• 🔑 دریافت توکن: پس از خرید اشتراک مناسب، توکن دسترسی اختصاصی خود را بردارید.

با این توکن می‌توانید به راحتی از تمامی متدهای وب سرویس استفاده کنید. این اطلاعات را نزد خود حفظ کنید.

راهنمای فنی اتصال و احراز هویت

شما برای فراخوانی متدها به احراز هویت نیاز دارید. سیستم یک access_token به شما ارائه می‌دهد. این توکن را باید به عنوان Username در روش Basic Auth ارسال کنید. علاوه بر این، باید کاراکتر دو نقطه یعنی “:” را به انتهای توکن اضافه کنید. سپس، رشته متنی حاصل را به فرمت Base64 تبدیل نمایید. فرمول این فرآیند به صورت زیر محاسبه می‌شود:

$$header\_value=\text{“Basic “}+Base64(access\_token+\text{“:”})$$

برای مثال، فرض کنید مقدار توکن شما برابر $abcd$ باشد. در این حالت، مقدار هدر ارسالی شما به صورت زیر خواهد بود:

Authorization: Basic YWJjZDo=

پاسخ تمام متدها به صورت یک سند JSON ارسال می‌شود. داده‌های اصلی در فیلد data قرار دارند:

{
  "data": [ ... ]
}

فیلدهای مربوط به تاریخ از نوع رشته هستند. این فیلدها از الگوی YYYYMMdd پشتیبانی می‌کنند. برای مثال، تاریخ ۱۴ خرداد سال ۱۴۰۵ به صورت 14050314 خواهد بود. همچنین فیلدهای زمان با الگوی YYYYMMddHHmmss ذخیره می‌شوند. منطقه زمانی این مقادیر بر اساس ساعت ایران یعنی $UTC+3:30$ است. اگر مقدار فیلدی تهی باشد، در خروجی نمایش داده نخواهد شد.

ساختار رکوردها و اطلاعات متا

هر رکورد یک شناسه منحصر‌به‌فرد متنی به نام id دارد. برنامه‌نویسان باید این فیلد را به صورت رشته متنی پردازش کنند. همچنین فیلد meta اطلاعات بیشتری درباره وضعیت هر رکورد ارائه می‌کند. ساختار زیر این موضوع را نشان می‌دهد:

{
  "data": [
    {
      "meta": {
        "version": 283184512,
        "state": "deleted",
        "insert_date_time": "13930714082148",
        "update_date_time": "13930718121432",
        "delete_date_time": "13930720220123"
      }
    }
  ]
}

فیلد version یک عدد صحیح از نوع Int64 است. این عدد با هر تغییر در رکورد افزایش می‌یابد. بنابراین، می‌توانید تغییرات جدید را به سرعت شناسایی کنید. فیلد state وضعیت جاری رکورد را نشان می‌دهد. مقادیر این فیلد شامل inserted، updated یا deleted است. سیستم هیچ رکوردی را به صورت فیزیکی حذف نمی‌کند. بنابراین وضعیت رکوردهای حذفی فقط به deleted تغییر می‌کند. در این شرایط فقط فیلدهای id و meta برگشت داده می‌شوند. فیلدهای insert_date_time و update_date_time زمان ثبت و ویرایش را نشان می‌دهند. همچنین زمان حذف رکورد با فیلد delete_date_time مشخص می‌شود.

روش بهینه استفاده از وب سرویس بازار بورس تهران

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

GET /method?_sort=meta.version&meta.version=1000&meta.version_op=gt

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

فیلتر کردن اطلاعات در وب سرویس بورس

برای محدود کردن اطلاعات دریافتی می‌توانید از فیلترهای متنوع استفاده کنید. نام فیلد را در درخواست ارسال کنید.

GET /method?id=100

علاوه بر این، امکان ترکیب چند فیلتر به صورت هم‌زمان وجود دارد:

GET /method?id=100&name=foo

جهت دریافت مقادیر مخالف یک مقدار خاص، عملگر neq را به کار ببرید:

GET /method?id=100&id_op=neq

برای مقایسه مقادیر از عملگرهای ریاضی استفاده کنید. این عملگرها شامل lt، lte، gt و gte هستند. به عنوان مثال، برای دریافت شناسه‌های کوچکتر از $100$ درخواست زیر را ارسال کنید:

GET /method?id=100&id_op=lt

همچنین عملگرهای in و nin برای فیلتر لیست مقادیر کاربرد دارند:

GET /method?id=100,200&id_op=in

برای پیدا کردن مقادیر در یک بازه معین از عملگر bw استفاده کنید:

GET /method?id=100,200&id_op=bw

این فیلتر مقادیر بین $100$ تا $200$ را نمایش می‌دهد. علاوه بر این، عملگرهای like و notlike برای جستجوی متنی مناسب هستند.

GET /method?name=foo&name_op=like

در نهایت، عملگرهای null و notnull وضعیت خالی بودن فیلد را بررسی می‌کنند.

GET /method?name_op=null

مدیریت نتایج و مرتب‌سازی داده‌ها

گاهی حجم نتایج بسیار بالا است. بنابراین، باید خروجی‌ها را با پارامترهای _count و _skip محدود کنید. درخواست زیر فقط 100 رکورد اول را برمی‌گرداند:

GET /method?_count=100

همچنین می‌توانید از ۲۰۰ رکورد اول صرف‌نظر کرده و داده‌های بعدی را دریافت کنید:

GET /method?_count=100&_skip=200

مقدار پیش‌فرض شمارش $50$ و حداکثر آن 100 رکورد است. جهت مرتب‌سازی داده‌ها نیز از پارامتر _sort استفاده کنید. این فیلد چینش اطلاعات را تغییر می‌دهد.

GET /method?_sort=-name

این دستور داده‌ها را بر اساس نام و به شکل نزولی مرتب می‌کند.

بسط دادن داده‌های مرتبط

به طور پیش‌فرض، در رکوردهای داخلی فقط فیلد id نمایش داده می‌شود. اما برای دریافت اطلاعات کامل‌تر باید از پارامتر _expand استفاده کنید. این ابزار داده‌ها را بسط می‌دهد. در این صورت، نام فیلد مربوطه را به صورت زیر ارسال کنید:

GET /method?_expand=company,instrument

در نتیجه، تمام اطلاعات شرکت و ابزار معاملاتی به صورت کامل نمایش داده می‌شوند.

مدیریت خطاها در وب سرویس

مدیریت خطاها بخش مهمی از برنامه‌نویسی است. این وب سرویس خطاهای استاندارد را ارسال می‌کند. اگر توکن نامعتبر باشد، سیستم خطای 401 صادر می‌کند. این خطا نشان‌دهنده عدم دسترسی مجاز است. همچنین در صورت ارسال اطلاعات اشتباه، خطای 422 دریافت خواهید کرد. جزئیات خطا در فیلد error قرار دارد. این خطا نشان‌دهنده غیرقابل پردازش بودن درخواست شما است.

متدهای کاربردی وب سرویس بورس تهران

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

• 📈 متد قیمت‌های لحظه‌ای: آخرین قیمت‌های معاملاتی هر نماد را با این متد دریافت کنید.
• 🏢 متد اطلاعات شرکت‌ها: این بخش اطلاعات پایه شرکت‌های بورسی را نمایش می‌دهد.

شما با استفاده از این متدها می‌توانید یک سامانه معاملاتی کامل را راه‌اندازی کنید.

جمع‌بندی و گام بعدی

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

• برچسب ها:
• api
• api اخبار معاملات
• api بورس
• api بورس تهران
• وب سرویس
• وب سرویس اخبار معاملات
• وب سرویس اوراق مشارکت
• وب سرویس بورس
• وب سرویس بورس تهران
• وب سرویس تسهیلات مسکن
• وب سرویس تقویم
• وب سرویس سهام
• وب سرویس صندوق سرمایه گذاری