نقاط پایانی

ساخت وبلاگ

API دارای یک نقطه پایانی به روز شده است که تمام ارزهای موجود را برمی گرداند. برای دریافت لیست ، درخواست API را به نقطه پایانی نمادها بسازید.

درخواست API:

https://api. exchangeratesapi. io/v1/نماد؟Access_Key = API_KEY

پارامترهای درخواست:

 

پارامتر شرح
کلید دسترسی [مورد نیاز] کلید API شما.

پاسخ API:

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
نماد تمام ارزهای پشتیبانی شده را با کدها و نام های ارزی سه حرف مربوطه باز می گرداند.

آخرین نرخ نقطه پایانی

این نقطه پایانی ، بسته به برنامه اشتراک شما ، داده های نرخ ارز در زمان واقعی را باز می گرداند که هر 60 دقیقه ، هر 10 دقیقه یا هر 60 ثانیه به روز می شود.

درخواست API:

https://api. exchangeratesapi. io/v1/آخرین؟Access_Key = API_KEY & BASE = USD & Symbols = GBP ، JPY ، EUR

پارامترهای درخواست:

 

پارامتر شرح
کلید دسترسی [مورد نیاز] کلید API شما.
پایه [اختیاری] کد ارز سه حرفی از ارز پایه مورد نظر خود را وارد کنید.
نماد [اختیاری] برای محدود کردن ارزهای خروجی ، لیستی از کدهای ارز جدا از کاما را وارد کنید.

پاسخ API:

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
زمان سنج تاریخ و زمان دقیق را برمی گرداند (تمبر زمان یونیکس) نرخ داده شده جمع آوری شد.
پایه کد ارزی سه حرفی از ارز پایه مورد استفاده برای این درخواست را برمی گرداند.
نرخ داده های نرخ ارز را برای ارزهای درخواست شده بازگرداند.

نقطه پایانی نرخ تاریخی

با استفاده از این نقطه پایانی ، ما این امکان را داریم که نرخ های تاریخی ارزها را به سال 1999 برگردانیم ، بیشتر داده های ارز تا سال 1999 در دسترس است. شما می توانید با افزودن یک تاریخ (قالب yyyy-mm-dd) از API مبادلات برای نرخ های تاریخی پرس و جو کنید. URL پایه.

درخواست API:

https://api. exchangeratesapi. io/v1/2013-12-24؟Access_Key = API_KEY & BASE = GBP & Symbols = USD ، CAD ، EUR

پارامترهای درخواست:

 

پارامتر شرح
yyyy-mm-dd [مورد نیاز] تاریخی در گذشته که برای آن نرخ های تاریخی درخواست شده است.
کلید دسترسی [مورد نیاز] کلید API شما.
پایه [اختیاری] کد ارز سه حرفی از ارز پایه مورد نظر خود را وارد کنید.
نماد [اختیاری] برای محدود کردن ارزهای خروجی ، لیستی از کدهای ارز جدا از کاما را وارد کنید.

پاسخ API:

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
تاریخی اگر درخواستی برای نرخ ارز تاریخی مطرح شد ، درست باز می گردد.
تاریخ تاریخی را که از نرخ های تاریخی درخواست شده است برمی گرداند.
زمان سنج تاریخ و زمان دقیق را برمی گرداند (تمبر زمان یونیکس) نرخ داده شده جمع آوری شد.
پایه کد ارزی سه حرفی از ارز پایه مورد استفاده برای این درخواست را برمی گرداند.
نرخ داده های نرخ ارز را برای ارزهای درخواست شده بازگرداند.

نمادها را مشخص کنید

برای کاهش پهنای باند ، می توانید تعداد ارزهای خروجی را به مجموعه خاصی از انتخاب خود در اکثر نقاط پایانی API محدود کنید. برای انجام این کار ، به سادگی پارامتر نمادهای مبدل API را به درخواست API خود اضافه کرده و آن را بر روی یک یا چند کد ارز جدا شده با کاما تنظیم کنید.

مثال:

https://api. exchangeratesapi. io/v1/latest؟Access_Key = API_KEYو نمادها = USD ، CAD ، JPY 

پاسخ API برای درخواست فوق محدود به ارزهای USD ، CAD و JPY خواهد بود.

تغییر ارز پایه

مشروط بر تغییر ارز پایه در برنامه اشتراک شما پشتیبانی می شود ، می توانید با ضخامت پارامتر پایه به URL درخواست API خود و تنظیم آن بر روی کد سه حرفی از ارز پایه مورد نظر خود ، ارز را که نرخ ارز خروجی شما به آن مربوط می شود ، تغییر دهید.

مثال:

https://api. exchangeratesapi. io/v1/latest؟Access_Key = API_KEY& base = usd 

لطفا توجه داشته باشید: ارز پایه پیش فرض یورو است.

تبدیل نقطه پایانی

این یک نقطه پایانی جداگانه برای تبدیل ارز است که همراه با API مبدل ها است و می تواند برای تبدیل مبلغی از یک ارز به دیگری استفاده شود. لطفاً برای تبدیل هر ارز از این نقطه پایانی API استفاده کنید.

همچنین می توان با استفاده از داده های نرخ ارز تاریخی ، ارزها را تبدیل کرد. برای انجام این کار ، لطفاً از پارامتر تاریخ API نیز استفاده کرده و آن را در تاریخ مورد نظر خود تنظیم کنید.(قالب yyyy-mm-dd).

درخواست API:

https://api. exchangeratesapi. io/v1/تبدیل؟Access_Key = api_key &از جانب = GBP & to = jpy & میزان = 25 

پارامترهای درخواست:

 

پارامتر شرح
کلید دسترسی [مورد نیاز] کلید API شما.
از جانب [مورد نیاز] کد ارز سه نامه ارز که می خواهید از آن تبدیل کنید.
to [مورد نیاز] کد ارز سه نامه ارز که می خواهید به آن تبدیل کنید.
میزان [مورد نیاز] مبلغی که باید تبدیل شود.
تاریخ [اختیاری] تاریخ (قالب yyyy-mm-dd) را برای استفاده از نرخ های تاریخی برای این تبدیل مشخص کنید.

پاسخ API:

<"success": true, "query": <"from": "GBP", "to": "JPY", "amount": 25>، "اطلاعات":<"timestamp": 1519328414, "rate": 148.972231>, "تاریخی": "" "date": "2018-02-22" "result": 3724.305775>

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
query>از جانب کد ارز سه نامه ارز تبدیل شده از آن را برمی گرداند.
query>به کد ارزی سه نامه ارز تبدیل شده به آن را برمی گرداند.
query>به مبلغی را که تبدیل شده است باز می گرداند.
info>زمان سنج تاریخ و زمان دقیق را برمی گرداند (تمبر زمان یونیکس) مبادله داده شده نادر جمع آوری شد.
info>نرخ نرخ ارز مورد استفاده برای تبدیل شما را برمی گرداند.
تاریخی اگر از نرخ های تاریخی برای این تبدیل استفاده شود ، درست باز می گردد.
تاریخ تاریخ را برمی گرداند (قالب yyyy-mm-dd) داده های نرخ ارز داده شده جمع آوری شد.
نتیجه نتیجه تبدیل شما را برمی گرداند.

نقطه پایانی سری

در صورت پشتیبانی از برنامه اشتراک خود ، نقطه پایانی سری API مبدل ها به شما امکان می دهد API را برای نرخ های تاریخی روزانه بین دو تاریخ مورد نظر خود ، با حداکثر بازه زمانی 365 روز پرس و جو کنید.

درخواست API:

https://api. exchangeratesapi. io/v1/سری زمانی؟Access_Key = api_key &تاریخ شروع = 2012-05-01 & تاریخ پایان = 2012-05-25 

پارامترهای درخواست:

 

پارامتر شرح
کلید دسترسی [مورد نیاز] کلید API شما.
تاریخ شروع [مورد نیاز] تاریخ شروع بازه زمانی مورد نظر شما.
تاریخ پایان [مورد نیاز] تاریخ پایان بازه زمانی مورد نظر شما.
پایه [اختیاری] کد ارز سه حرفی از ارز پایه مورد نظر خود را وارد کنید.
نماد [اختیاری] برای محدود کردن ارزهای خروجی ، لیستی از کدهای ارز جدا از کاما را وارد کنید.

پاسخ API:

<"success": true, "timeseries": true, "start_date": "2012-05-01", "end_date": "2012-05-03", "base": "EUR", "rates": <"2012-05-01":<"USD": 1.322891, "AUD": 1.278047, "CAD": 1.302303>، "2012-05-02":<"USD": 1.315066, "AUD": 1.274202, "CAD": 1.299083>، "2012-05-03":<"USD": 1.314491, "AUD": 1.280135, "CAD": 1.296868>, [. ]>>

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
سری زمانی اگر درخواستی به نقطه پایانی Timeseries ارائه شود ، درست باز می گردد.
تاریخ شروع تاریخ شروع چارچوب زمانی شما.
تاریخ پایان تاریخ پایان بازه زمانی شما.
پایه کد ارزی سه حرفی از ارز پایه مورد استفاده برای این درخواست را برمی گرداند.
نرخ داده های نرخ ارز را برای ارزهای درخواست شده بازگرداند.

نقطه پایانی

با استفاده از نقطه پایانی API نوسان ، می توانید اطلاعات مربوط به نوسان ارز را به صورت روزانه دریافت کنید. برای اینکه بتوانید از این ویژگی استفاده کنید ، start_date و end_date را اضافه کرده و کدام ارز (نمادها) را می خواهید از API دریافت کنید. لطفاً توجه داشته باشید که حداکثر بازه زمانی مجاز 365 روز است.

درخواست API:

https://api. exchangeratesapi. io/v1/نوسان؟Access_Key = api_key &تاریخ شروع = 2015-12-01 & تاریخ پایان = 2015-12-24 

پارامترهای درخواست:

 

پارامتر شرح
کلید دسترسی [مورد نیاز] کلید API شما.
تاریخ شروع [مورد نیاز] تاریخ شروع بازه زمانی نوسان مورد نظر شما.
تاریخ پایان [مورد نیاز] تاریخ پایان بازه زمانی نوسان مورد نظر شما.
پایه [اختیاری] کد ارز سه حرفی از ارز پایه مورد نظر خود را وارد کنید.
نماد [اختیاری] برای محدود کردن ارزهای خروجی ، لیستی از کدهای ارز جدا از کاما را وارد کنید.

پاسخ API:

اشیاء پاسخ:

 

موضوع پاسخ شرح
موفقیت بسته به اینکه درخواست API شما موفق شده است ، درست یا غلط برمی گردد.
نوسان اگر درخواستی به نقطه پایانی نوسان مطرح شود ، درست باز می گردد.
تاریخ شروع تاریخ شروع چارچوب زمانی شما.
تاریخ پایان تاریخ پایان بازه زمانی شما.
پایه کد ارزی سه حرفی از ارز پایه مورد استفاده برای این درخواست را برمی گرداند.
نرخ داده های نرخ ارز را برای ارزهای درخواست شده بازگرداند.
rates>start_rate مبادله جمع آوری شده در تاریخ شروع شما را برمی گرداند.
rates>end_rate مبادله جمع آوری شده در تاریخ پایان شما را برمی گرداند.
rates>تغییر دادن تغییر (تعداد اعشاری) نرخ ارز داده شده بین تاریخ شروع و پایان شما را برمی گرداند.
rates>تغییر دادن درصد تغییر نرخ ارز داده شده بین تاریخ شروع و پایان شما را برمی گرداند.

رمز نمونه

PHP (حلقه)

نرخ های زمان واقعی: در زیر یک مثال ساده PHP برای دریافت داده های نرخ ارز از طریق آخرین نقطه پایانی API Exchangerates پیدا کنید.

// تنظیم نقطه انتهایی API و کلید API $ endpoint = 'آخرین' ؛$ Access_Key = 'API_KEY' ؛// اولیه سازی CURL: $ ch = curl_init ('https://api. exchangeratesapi. io/v1/'. lendendpoint.'acess_key='. $ACCESS_KEY.' ') ؛curl_setopt ($ ch ، curlopt_retutransfer ، true) ؛// داده ها را ذخیره کنید: $ json = curl_exec ($ ch) ؛curl_close ($ ch) ؛// رمزگشایی پاسخ JSON: $ مبدل = json_decode ($ json ، true) ؛// به مقادیر نرخ ارز ، به عنوان مثال دسترسی پیدا کنیدGBP: ECHO $ مبادله ['نرخ'] ['GBP'] ؛

تبدیل ارزها: در اینجا نحوه تبدیل ارزها با استفاده از PHP CURL آورده شده است.

// تنظیم نقطه انتهایی API ، کلید دسترسی ، پارامترهای مورد نیاز $ endpoint = 'Convert' ؛$ Access_Key = 'API_KEY' ؛$ از = 'USD' ؛$ به = 'یورو' ؛$ مقدار = 10 ؛// اولیه سازی CURL: $ ch = curl_init ('https://api. exchangeratesapi. io/'. lendendpoint. Access_Key='. $ ACCSESS_KEY.'& from='. $from.'& to='.$ به. '& مقدار ='. $ مبلغ. '') ؛curl_setopt ($ ch ، curlopt_retutransfer ، true) ؛// دریافت داده های JSON: $ json = curl_exec ($ ch) ؛curl_close ($ ch) ؛// رمزگشایی JSON پاسخ: $ ConversionResult = json_decode ($ json ، true) ؛// دسترسی به نتیجه تبدیل Echo $ ConversionResult ['نتیجه'] ؛

JavaScript (jQuery. ajax)

نرخ های زمان واقعی: در زیر یک مثال ساده jQuery. ajax برای دریافت داده های نرخ ارز از طریق آخرین نقطه پایان API Exchangerates پیدا کنید.

// تنظیم نقطه انتهایی و کلید دسترسی شما = "آخرین" Access_Key = 'API_KEY' ؛// جدیدترین نرخ ارز را از طریق نقطه پایانی "آخرین" دریافت کنید: $ . ajax (>);

تبدیل ارزها: در اینجا نحوه تبدیل ارزها با استفاده از jQuery. ajax آورده شده است.

// تنظیم نقطه انتهایی و نقطه انتهایی API شما = 'Convert' ؛Access_Key = 'api_key' ؛// تعریف از ارز ، ارز و مبلغ از = 'یورو' ؛به = 'gbp' ؛مقدار = '10' ؛// اجرای تبدیل با استفاده از نقطه پایانی "تبدیل": $ . ajax (>);

هنوز کلید API ندارید؟اکنون یکی را دریافت کنید ، دسترسی فوری رایگان است

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

برچسب : نویسنده : احمد قانع پور بازدید : 29 تاريخ : پنجشنبه 19 مرداد 1402 ساعت: 0:28