دسترسی برنامهای (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/search?q=گلاسه&category=PAPER&type=GLS&page=0&size=20
یک ماده و تاریخچه قیمتش
GET /api/v1/materials/ps_1030_10229
GET /api/v1/materials/ps_1030_10229/prices?from=2026-09-01&to=2026-10-04
قیمت چند کد در یک روز (برای ERP)
برای هر کد آخرین قیمتِ ثبتشده تا آن روز برمیگردد. کدی که هنوز قیمت ندارد "price": null میگیرد و کدی که وجود ندارد "found": false.
GET /api/v1/prices?codes=ps_1030_10229,ps_1030_10228&date=2026-10-04
مشخصههای یک نوع
مشخصههایی که هر مادهی این نوع با آنها توصیف میشود، مقادیر مجاز مشخصههای فهرستی و واحدهای قیمت. مشخصههایی که "identity": true دارند با هم تعیین میکنند هر ماده کدام است.
GET /api/v1/types/PAPER/FBB
کد ثابت یک ماده از روی مشخصاتش
برای وصل کردن کالای سیستم خودتان به کد بازار: مقدار هر مشخصه را با کد همان مشخصه بفرستید. عددها و ابعاد هر طور نوشته شوند یکسان سنجیده میشوند (۲۷۰ = 270.0، ۱۰۰×۷۰ = 100*70). اگر مادهای با این مشخصات نباشد "found": false برمیگردد؛ کد تازه را فقط پارسیس میسازد.
GET /api/v1/materials/match?category=PAPER&type=FBB&brand=نینگبو&grain=LG&gsm=270&size=100x70&sheetsPerBundle=100
سرویسها
درخت سرویسها با کد ثابت هر سرویس (SRV-PRN-0001)، کد گروه بالاتر و انواع کالایی که مصرف میکند.
GET /api/v1/services
GET /api/v1/services/SRV-PRN-0001
سیستمهای متصل (ParsysERP، NODE، پنل تأمینکنندگان)
هر سیستم متصل کلید API خودش را از پارسیس میگیرد و آن را در سرآیند X-Api-Key میفرستد. با آن کدهای خودش را به کد بازار وصل میکند،
قیمت روز را با کد و واحد خودش میخواند و فهرست تغییرات را دنبال میکند. unitRatio یعنی هر واحد شما چند برابر واحد بازار است
(بند ۱۸٫۹ کیلویی وقتی بازار قیمت هر کیلو را میدهد: 18.9).
GET /api/v1/client/me
GET /api/v1/client/mappings
PUT /api/v1/client/mappings {"localCode":"10023","code":"ps_1030_10229","localUnit":"بند","unitRatio":18.9}
POST /api/v1/client/mappings [ {...}, {...} ] (تا ۲۰۰۰ مورد؛ هر مورد جدا نتیجه میگیرد)
DELETE /api/v1/client/mappings?localCode=10023
GET /api/v1/client/prices?date=2026-11-09
GET /api/v1/client/changes?since=0&limit=500
هر تغییر یک شماره نسخه دارد؛ پاسخ to را نگه دارید و دفعه بعد با since بفرستید.
اگر نشانیای دارید که بازار به آن دسترسی دارد، پارسیس میتواند همین پاسخ را هر دقیقه برایتان POST کند، امضاشده:
X-Bazar-Signature: sha256=HMAC-SHA256(secret, X-Bazar-Timestamp + "." + body). یک تغییر ممکن است دو بار برسد؛ با شماره نسخه تکراریها را کنار بگذارید.
معنای فیلدها
- price
- قیمت مرجع روز در واحد ماده (unit: KG، BUNDLE، ...).
- pricePerKilo / pricePerBundle
- قیمت هر کیلوگرم و هر بند، وقتی معلوم باشد.
- minPrice / maxPrice / offers
- کمترین و بیشترین پیشنهاد و تعداد پیشنهادهای آن روز.
- method
- LOWEST_CASH: کمترین پیشنهاد نقدیِ موجود؛ LOWEST: کمترین پیشنهاد وقتی پیشنهاد نقدی نبوده؛ MANUAL: ثبتشده توسط پارسیس.