###GET /bourse/v2/clients/{clientId}/goldMetalValueDaily * **شرح:** در این وب­سرویس، اطلاعات روزانه نرخ فلزات گرانبها براساس شناسه­ی نوع فلزگرانبها ارائه می­شود. اگر بازه تاریخ مشخص نشود، اطلاعات آخرین روز کاری داده میشود. * **اسکوپ:** ```bourse:goldMetalValue-daily:get``` * **رویکرد:** ```Client_Credential``` ```````````````` {address}/bourse/v2/clients/{clientId}/goldMetalValueDaily?trackId={trackId}&metalId={metalId}&from={from}&to={to} ```````````````` <div class="sandboxaddress sandbox" id="sandbox" style="float:right" style="display: none" > https://sandboxapi.finnotech.ir <b> :address </b> </div> <div class="production-address production" style="float:right" style="display: block"> https://apibeta.finnotech.ir <b> :address </b> </div> #### Headers مقادیر زیر باید در هدر قرار بگیرد ```````````````` Authorization : Bearer {Token} ```````````````` * برای فراخوانی این سرویس نیازی به افزودن حساب نمی باشد و میتوانید با توکن بدون حساب، سرویس را فراخوانی کنید #### URI Parameters * **clientId: ** شناسه کلاینت #### Query Parameters اگر هیچ پارامتری به‌عنوان ورودی سرویس داده نشود، فهرستی از تمام فلزات گرانبها به همراه با آخرین نرخ هرکدام داده خواهد شد. بازه تاریخی حداکثر تا یک ماه قبل میباشد. اگر فقط FromDate مشخص شود ، ToDateامروز در نظر گرفته میشود. اطلاعات قبل از آن به صورت فایل ارائه میشود. * **trackId:** (اختیاری) ‫ رشته ای با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. پیشنهاد ما برای trackId تولید کردن UUID است. در صورت نیاز به نتیجه یک فراخوانی میتوانید با trackId آن را فیلتر کنید. در گزارش فراخوانی سرویس فراخوانی مورد نظر را با همین کد پیگیری پیدا میکنید. * example: ```8e15adc9-6e14-460a-9112-422567bc0e34``` * **metalId:** (اختیاری) شناسه‌ی نوع فلز گران‌بها، برای اطلاعات بیشتر درمورد شناسه‌ی فلزات گرانبها به سرویس [عناوین نوع فلز گرانبها](/doc/bourse-precMetals.html?sandbox=+sandbox) رجوع کنید. * **from:** (اختیاری) تاریخ شروع بازه yyyymmdd * **to:** (اختیاری) تاریخ پایان بازه yyyymmdd ####Results Format ##### Successful result format (status code 200) { "result":{[ "PrecMetalID": 127 , "PrecMetalSymbol": "platinum" , "PrecMetalName": "انس جهانی پلاتین" , "PrecMetalValues": [ { "PrecMVID": 4570342 , "DateTime": "2018/05/28 12:00:13" , "ShamsiDate": "1397/03/07" , "PrecMetalOpeningValue": 899.9 , "PrecMetalMinValue": 899.9 , "PrecMetalMaxValue": 904.7 , "PrecMetalLastValue": 903.7 }, { "PrecMVID": 4570343 , "DateTime": "2018/05/28 11:52:20" , "ShamsiDate": "1397/03/07" , "PrecMetalOpeningValue": 971 , "PrecMetalMinValue": 971 , "PrecMetalMaxValue": 977.3 , "PrecMetalLastValue": 977.1 }] ]} , "trackId": "8e15adc9-6e14-460a-9112-422567bc0e34" , "status": "DONE" } * **result:** آبجکتی از پاسخ سرویس شامل: * **PrecMetalID:** شناسه‌ی نوع فلز گرانبها * **PrecMetalSymbol:** نماد نوع فلز گرانبها * **PrecMetalName:** نام نوع فلز گرانبها * **PrecMetalValues:** اطلاعات مربوط به نرخ * **PrecMVID:** شناسه‌ی نرخ فلز گرانبها * **DateTime:** تاریخ میلادی * **ShamsiDate:** تاریخ شمسی * **PrecMetalOpeningValue:** نخستین نرخ نوع فلز گرانبها * **PrecMetalMinValue:** کمترین نرخ نوع فلز گرانبها * **PrecMetalMaxValue:** بیشترین نرخ نوع فلز گرانبها * **PrecMetalLastValue:** بیشترین نرخ نوع فلز گرانبها (در تاریخ امروز، نشان‌دهنده‌ی نرخ نوع فلز گرانبها در زمان فراخوانی سرویس است) * **trackId:** کد پیگیری، اگر ارسال شده باشد همان مقدار برگردانده میشود و در غیر اینصورت یک رشته تصادفی تولید و برگردانده می‌‌شود * **status:** وضعیت تراکنش * **DONE:** در صورت موفق بودن عملیات رخ میدهد * **FAILED:** در صورت ناموفق بودن عملیات رخ میدهد * **error:** جزییات خطا (در صورت بروز خطا) #### UnSuccessful result format در اینجا میتوانید لیست خطاهای سرویس ها را مشاهده کنید [لیست خطاها](/generic-errors.html)