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

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

درخواست 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	بله	ارز مورد درخواست. در صورت تنظیم، تنها ارز مورد درخواست ارائه می شود. به جدول مقادیر ممکن رجوع کنید
dollar_rate	بله، فقط برای رمز ارز	true, flase در صورت تنظیم مقدار دلاری رمز ارز نیز ارائه می شود. موارد زیر به پاسخ اضافه می گردد. dollar_rate , dollar_rate_time , dollar_rate_24h_change , dollar_rate_24h_vol
dirham_rate	بله، فقط برای رمز ارز	true, flase در صورت تنظیم مقدار درهمی رمز ارز نیز ارائه می شود. موارد زیر به پاسخ اضافه می گردد. dirham_rate , dirham_rate_time , dirham_rate_24h_change , dirham_rate_24h_vol

پاسخ

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

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

برای رمز ارزها:

dollar_rate: نرخ دلاری 
dollar_rate_time: زمان بروز رسانی نرخ دلاری 
dollar_rate_24h_change: تغییر نرخ دلاری نسبت به 24 ساعت گذشته 
dollar_rate_24h_vol: حجم معاملات دلاری 24 ساعت گذشته 

dirham_rate: نرخ درهمی 
dirham_rate_time: زمان بروز رسانی نرخ درهمی 
dirham_rate_24h_change: تغییر نرخ درهمی نسبت به 24 ساعت گذشته 
dirham_rate_24h_vol: حجم معاملات درهمی 24 ساعت گذشته 

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

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

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

درخواست 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: پایان روز

وب سرویس اطلاع از میزان مصرف

اطلاع از تعداد درخواست های ارسال شده توسط کاربر

درخواست HTTP

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

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

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

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

{
    "id": "181230"
    "api_key": "شما-API-کلید"
    "monthly_usage": "1123"
    "daily_usage": "87"
    "hourly_usage": "11"
    "ips": "null"
    "last_use": "2025-11-25 17:56:04"
}

پارامترهای URL

پارامتر	اختیاری	توضیح
api_key	خیر	کلید API

پاسخ

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

کد	وضعیت	توضبح
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"
}