دسترسی برنامه‌ای (API)

همه قیمت‌های بازار پارسیس با کد ثابت هر ماده از نشانی‌های زیر خوانده می‌شوند. مبلغ‌ها به ریال و تاریخ‌ها میلادی (ISO) هستند. پاسخ JSON است و نیازی به ورود ندارد.

فهرست دسته‌ها و انواع

GET /api/v1/categories

همه مواد یک دسته یا یک نوع، با آخرین قیمت

GET /api/v1/materials?category=PAPER
GET /api/v1/materials?category=PAPER&type=GLS

یک ماده و تاریخچه قیمتش

GET /api/v1/materials/PAP-GLS-0004
GET /api/v1/materials/PAP-GLS-0004/prices?from=2026-09-01&to=2026-10-04

قیمت چند کد در یک روز (برای ERP)

برای هر کد آخرین قیمتِ ثبت‌شده تا آن روز برمی‌گردد. کدی که هنوز قیمت ندارد "price": null می‌گیرد و کدی که وجود ندارد "found": false.

GET /api/v1/prices?codes=PAP-FBB-0001,PAP-GLS-0004&date=2026-10-04

معنای فیلدها

price

قیمت مرجع روز در واحد ماده (unit: KG، BUNDLE، ...).

pricePerKilo / pricePerBundle

قیمت هر کیلوگرم و هر بند، وقتی معلوم باشد.

minPrice / maxPrice / offers

کمترین و بیشترین پیشنهاد و تعداد پیشنهادهای آن روز.

method

LOWEST_CASH: کمترین پیشنهاد نقدیِ موجود؛ LOWEST: کمترین پیشنهاد وقتی پیشنهاد نقدی نبوده؛ MANUAL: ثبت‌شده توسط پارسیس.