شروع سریع

1. ثبت‌نام (یا ورود) با شمارهٔ موبایل در نِت اَرز ثبت‌نام کنید. همان حساب برای فروشگاه، API هوش مصنوعی و این سرویس کار می‌کند.
2. یک اپ بسازید در پنل ← API نرخ ارز روی «اپ جدید» بزنید: یک نام (مثلاً «سایت فروشگاه») و دامنه‌ای که از آن درخواست می‌فرستید (example.com). کلید fx-ntz-v1-… فقط همین یک‌بار نمایش داده می‌شود — کپی‌اش کنید.
3. مالکیت دامنه را تأیید کنید یکی از دو روش زیر کافی است؛ پس از ثبت، در پنل «بررسی و تأیید» را بزنید. دامنه‌های توسعه (localhost، *.test) خودکار تأیید می‌شوند.
   روش ۱ — DNS

   # رکورد TXT — از پنل، مقدار دقیق را کپی کنید
   _netarz.example.com.   TXT   "netarz-fx-verify=ntz-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

   روش ۲ — فایل

   # یا این فایل را با همین محتوا روی سایت بگذارید
   https://example.com/.well-known/netarz-fx-verify.txt
   → ntz-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4. اولین درخواست از مرورگر روی همان دامنه، یا از سرور بعد از این‌که IP آن را در پنل به «IPهای مجاز» اضافه کردید:
   JavaScript Python PHP cURL

   JavaScript

   const res = await fetch("https://netarz.ir/api/fx/v1/rates?codes=USD,EUR,AED", {
     headers: { Authorization: "Bearer fx-ntz-v1-..." },
   });
   
   if (!res.ok) {
     const { error } = await res.json();
     throw new Error(`${error.code}: ${error.message}`);
   }
   
   const { data, meta } = await res.json();
   console.log(data.map(r => `${r.code}: ${r.buy} / ${r.sell}`).join("\n"));
   console.log("as of", meta.as_of, meta.is_delayed ? `(+${meta.delayed_minutes}m)` : "(live)");

   Python

   import requests
   
   API = "https://netarz.ir/api/fx/v1"
   HEADERS = {"Authorization": "Bearer fx-ntz-v1-..."}
   
   r = requests.get(f"{API}/rates", params={"codes": "USD,EUR,AED"}, headers=HEADERS, timeout=10)
   r.raise_for_status()
   
   for row in r.json()["data"]:
       print(row["code"], row["buy"], row["sell"], row["change_24h_percent"])

   PHP

   <?php
   use Illuminate\Support\Facades\Http;
   
   $response = Http::withToken(env('NETARZ_FX_KEY'))
       ->get('https://netarz.ir/api/fx/v1/rates', ['codes' => 'USD,EUR,AED'])
       ->throw();
   
   foreach ($response->json('data') as $row) {
       echo "{$row['code']}: {$row['buy']} / {$row['sell']}\n";
   }

   cURL

   curl "https://netarz.ir/api/fx/v1/rates?codes=USD,EUR,AED" \
     -H "Authorization: Bearer fx-ntz-v1-..."

بعدش چه؟