وب سرویس آخرین قیمت ها

دریافت جدید ترین نرخ های لحظه ای شامل زمان بروز رسانی و تغییرات نسبت به روز پیشین ...

درخواست HTTP

GET http://api.navasan.tech/latest/?api_key=شما-API-کلید

curl "http://api.navasan.tech/latest/?api_key=شما-API-کلید"

require 'net/http'
require 'uri'
res = Net::HTTP.get URI('http://api.navasan.tech/latest/?api_key=شما-API-کلید')

دستور فوق JSON به شکل زیر باز می گرداند:

{
    "harat_naghdi_buy": {
        "value": "11270",
        "change": -25,
        "timestamp": 1568212950,
        "date": "1398-06-20 19:12:30",
    },
    "harat_naghdi_sell": {
        "value": "11290",
        "change": -30,
        "timestamp": 1568212950,
        "date": "1398-06-20 19:12:30",
    },
    
    ...
}

پارامترهای URL

پارامتر	اختیاری	توضیح
api_key	خیر	کلید API
item	بله	ارز مورد درخواست. در صورت تنظیم، تنها ارز مورد درخواست ارائه می شود. به جدول مقادیر ممکن رجوع کنید

پاسخ

پاسخ شامل آرایه های نرخ، زمان، مقدار می باشد که به صورت مقابل ساختار بندی شده اند

value: آخرین نرخ
change: مقدار تغییر نسبت به آخر وقت روز گذشته
timestamp: زمان بروزرسانی به صورت نشانگرها زمانی لینوکس
date: تاریخ شمسی
نوع ارز شماره 1  مثال دلار هرات نقدی خرید
نوع ارز شماره 2  مثال دلار هرات نقدی فروش

مقادیر بازگشتی را ببینید

وب سرویس قیمت ها برای روز

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

درخواست HTTP

GET http://api.navasan.tech/dailyCurrency/?api_key=شما-API-کلید

curl "http://api.navasan.tech/dailyCurrency/?item=usd_sell&date=1398-06-20"

require 'net/http'
require 'uri'
res = Net::HTTP.get URI('http://api.navasan.tech/dailyCurrency/?item=usd_sell&date=1398-06-20')

دستور فوق JSON به شکل زیر باز می گرداند:

{ 
    {
        "timestamp": 1568212950,
        "date": 1398-06-20,
        "value": "11100",
        "change": "",
    },
    {
        "timestamp": 1568212950,
        "date": 1398-06-20,
        "value": 11120,
        "change": 20,
    },
    
    ...
}

پارامترهای URL

پارامتر	اختیاری	توضیح
item	خیر	ارز مورد درخواست. به جدول مقادیرممکن رجوع کنید
date	خیر	تاریخ مورد درخواست به صورت به صورت نشانگر زمانی لینوکس و یا تاریخ شمسی

پاسخ

پاسخ شامل آرایه های زمان، قیمت، تغییر می باشد که به صورت مقابل ساختار بندی شده اند

timestamp: زمان بروزرسانی به صورت نشانگرها زمانی لینوکس
date: تاریخ شمسی
value: قیمت
change: مقدار تغییر نسبت به قیمت قبلی

وب سرویس آرشیو روزانه

دریافت آرشیو نرخ های آغاز، بیشینه، کمینه و پایان روز در بازه زمانی مورد نیاز

درخواست HTTP

GET http://api.navasan.tech/ohlcSearch/?api_key=شما-API-کلید

curl "http://api.navasan.tech/ohlcSearch/?item=usd_sell&start=1398-05-17&end=1398-06-17"

require 'net/http'
require 'uri'
res = Net::HTTP.get URI('http://api.navasan.tech/ohlcSearch/?item=aed_sell&start=1398-05-17&end=1398-06-17')

دستور فوق JSON به شکل زیر باز می گرداند:

{ 
    {
        "timestamp": 1565206200,
        "date": "1398-05-17",
        "open": "11100",
        "high": "11220",
        "low": "10990",
        "close": "10995",
    },
    {
        "timestamp": 1565206200,
        "date": "1398-05-17", 
        "open": "11200",
        "high": "11320",
        "low": "10995",
        "close": "11000",
    },
    
    ...
}

پارامترهای URL

پارامتر	اختیاری	توضیح
item	خیر	ارز مورد درخواست. به جدول مقادیرممکن رجوع کنید
start	خیر	تاریخ شروع به صورت به صورت نشانگر زمانی لینوکس و یا تاریخ شمسی
end	خیر	تاریخ پایان به صورت به صورت نشانگر زمانی لینوکس و یا تاریخ شمسی

پاسخ

پاسخ شامل آرایه های زمان، آغاز روز، بیشینه، کمینه، پایان روز می باشد که به صورت مقابل ساختار بندی شده اند

timestamp: زمان بروزرسانی به صورت نشانگرها زمانی لینوکس
date: تاریخ شمسی
open: آغاز روز
high: بیشینه
 low: کمینه
close: پایان روز

کد	وضعیت	توضبح
200	OK	پاسخ درست است. بدنه پاسخ شامل داده های درخواستی خواهد بود.
400	Bad Request	خطایی در درخواست وجود دارد. بدنه پاسخ اطلاعات بیشتری خواهد داشت
401	Unauthorized	نشانه نامعتبر است اگر کلید API شما اشتباه است ، 401 نیز ارائه می شود ، بنابراین بدنه پاسخ را بررسی کنید ، ممکن است این باشد که API_KEY نامعتبر است.
422	Unprocessable Entity	خطایی در درخواست وجود دارد. بدنه پاسخ اطلاعات بیشتری خواهد داشت. برخی دلایل احتمالی: - پارامترها موجود نیستند - فرمت داده اشتباه است
429	Too Many Requests	این وضعیت نشان می دهد که کاربر درخواست های زیادی را در مدت زمان معینی ارسال کرده است
503	Service Unavailable	جزئیات در بدنه ارائه می شود - یک خطای داخلی. - برنامه شما در حال تلاش برای دسترسی به تماس API است که به آن دسترسی ندارید. - حد استفاده API. اگر به محدودیت استفاده API رسیدید ، 503 بازگردانده می شود ، لطفاً صبر کنید تا دوباره بتوانید تماس برقرار کنید.

1457974024 (for 2016-03-14T16:47:04 in ISO 8601)

خطاها

{
  "message": "missing parameters"
}