نرخ ارز الان چند

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

مشخصات

مشخصه	مقدار
دسته‌بندی	اطلاعات
وضعیت	فعال
نسخه API	apis-1
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-1/alanchand
لینک کامل	https://open.nestapi.ir/apis-1/alanchand

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-1/alanchand	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
currency	string	خیر	—	نام یا کد ارز برای فیلتر، مثلاً usd یا دلار؛ در صورت ارسال نشدن، فهرست کامل ارزها برگردانده می‌شود

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-1/alanchand

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/alanchand"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->alanchand();

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.alanchand()

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.alanchand();

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
UPSTREAM_UNAVAILABLE	503	سرویس مبدا در دسترس نیست
CURRENCY_NOT_FOUND	404	ارز موردنظر یافت نشد

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی