پاسخ قیمت‌های جاری

برای آخرین رکوردها از GET /api/v1/assets و برای یک دارایی از GET /api/v1/assets/{assetName} استفاده کنید. هر دو مسیر به کلید API معتبر نیاز دارند.

قرارداد دقیق پاسخ

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

{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "quoteUnit": "RLS",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>"
}

دریافت چند نماد انتخابی

پارامتر اختیاری codes حداکثر ۱۰۰ کد نماد متمایز را با همان ترتیب درخواست برمی‌گرداند. کدهای تکراری حذف می‌شوند و انتخاب خالی، کد ناشناخته یا بیش از ۱۰۰ کد با خطای مستند HTTP 400 رد می‌شود. این فراخوانی مانند دریافت فهرست کامل، فقط یک واحد از سهمیه مصرف می‌کند. برای کدها، دسته‌بندی و واحدها، کاتالوگ احرازشده را مرجع قرار دهید.

GET /api/v1/assets?codes=USD_RLS,EUR_RLS,GOLD_18_RLS

استفاده از قیمت‌های انتخابی در Vue

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

تازگی و کش

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