GOLDPRICE.IR
شنبه ۹ آبان ۱۴۰۵
API نسخه v1 آماده اتصال

داده بازار را در چند دقیقه به محصولتان متصل کنید

نرخ طلا، ارز، نفت، بازار جهانی، سهام و ارز دیجیتال را با JSON استاندارد دریافت کنید. یک ماه دسترسی آزمایشی برای ارزیابی واقعی در پروژه شما در دسترس است.

عضویت سریع با موبایل یا Google؛ فعال‌سازی از ناحیه کاربری

goldprice.ir/v1/quotes/gold-18
GET /v1/quotes/gold-18

{
  "success": true,
  "data": {
    "reference": "gold-18",
    "market": "gold",
    "title": "طلای 18 عیار",
    "value": "23,800,729",
    "unit": "تومان"
  }
}
نسخه فعالv1قرارداد نسخه‌بندی‌شده
فرمت پاسخJSON
دسترسیAPI Key
سهمیهماهانه

برای ساخت محصولی متکی به داده

از نمایش ساده قیمت تا سامانه‌های تحلیلی و داشبوردهای سازمانی.

آخرین نرخ

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

رفرنس‌های سیستم

شناسه و مشخصات رفرنس‌های مجاز را مستقیماً از endpoint فهرست دریافت کنید.

دسترسی امن

احراز هویت با API Key، محدودسازی بازار و مدیریت سهمیه درخواست‌ها.

فرمت استاندارد

خروجی JSON خوانا، نسخه‌بندی endpointها و خطاهای قابل پیش‌بینی.

شروع آزمایش در سه گام

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

۱

عضویت در GoldPrice

با شماره موبایل یا حساب Google وارد شوید و نام و نام خانوادگی را تکمیل کنید.

۲

فعال‌سازی پلان آزمایشی

در «پلان‌ها و API» شماره موبایل را تأیید و دسترسی یک‌ماهه را فعال کنید. کلید فقط یک‌بار نمایش داده می‌شود.

۳

اولین فراخوانی v1

API Key را با قالب Bearer بفرستید؛ ابتدا references را بخوانید و سپس نرخ رفرنس را دریافت کنید.

عضویت و دریافت API Key
GET/v1/referencesفهرست رفرنس‌های مجاز
GET/v1/marketsفهرست بازارهای مجاز
GET/v1/markets/{market}همه نرخ‌های یک بازار
GET/v1/quotes/{reference}آخرین نرخ یک رفرنس

اولین درخواست

Base URL نسخه فعلی https://goldprice.ir/v1 است.

curl -X GET "https://goldprice.ir/v1/quotes/gold-18" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
const response = await fetch(
  "https://goldprice.ir/v1/quotes/gold-18",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
if (!response.ok) throw new Error(`API ${response.status}`);
const payload = await response.json();
$curl = curl_init('https://goldprice.ir/v1/quotes/gold-18');
curl_setopt_array($curl, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_HTTPHEADER => [
		'Authorization: Bearer YOUR_API_KEY',
		'Accept: application/json'
	]
]);
$payload = json_decode(curl_exec($curl), true);
curl_close($curl);
کلید را در کد سمت کاربر یا مخزن عمومی قرار ندهید. Header X-API-Key نیز پشتیبانی می‌شود.

قرارداد پاسخ v1

همه پاسخ‌ها envelope ثابت دارند تا مدیریت موفقیت و خطا قابل پیش‌بینی باشد.

پاسخ موفق

success برابر true، داده در data و اطلاعات نسخه، زمان، تعداد نتیجه و سهمیه باقی‌مانده در meta قرار می‌گیرد.

پاسخ خطا

data برابر null و خطا شامل error.code و error.message است. وضعیت‌های 401، 403، 404 و 429 را مدیریت کنید.

کنترل سهمیه

سقف و مانده سهمیه در Headerهای X-RateLimit-Limit و X-RateLimit-Remaining و همچنین meta.quota_remaining برمی‌گردد.

کدهای خطای متداول v1
API_KEY_REQUIREDINVALID_API_KEYACCOUNT_EXPIREDPERMISSION_DENIEDMARKET_NOT_ALLOWEDMONTHLY_QUOTA_EXCEEDEDREFERENCE_NOT_FOUND

پوشش کامل بازار

یک API برای داده‌هایی که محصول مالی شما نیاز دارد.

طلا
سکه
ارز
جفت‌ارزها
ارز دیجیتال
بازار جهانی

از ارزیابی فنی تا مقیاس سازمانی

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

پایه

برای سرویس‌های کوچک با تمرکز روی طلا.

۱۰,۰۰۰ درخواست در ماه
  • طلا و بازار جهانی
  • سه دسترسی خواندن v1
  • مناسب اتصال اولیه
درخواست پلان پایه

حرفه‌ای

برای وب‌سایت و اپلیکیشن در حال رشد.

۵۰,۰۰۰ درخواست در ماه
  • طلا، ارز، نفت و بازار جهانی
  • سه دسترسی خواندن v1
  • مناسب محصول فعال
دریافت پیشنهاد حرفه‌ای

سازمانی

برای ترافیک بالا و پوشش کامل داده.

۱۰۰,۰۰۰ درخواست در ماه
  • همه بازارهای قابل ارائه
  • امکان محدودسازی IP
  • نیازهای اختصاصی سازمان
گفتگو با کارشناس

سوالات متداول

پاسخ کوتاه به پرسش‌های رایج فنی و تجاری.

چطور تست API را شروع کنم؟

عضو GoldPrice شوید، پروفایل و موبایل را تأیید کنید و در بخش «پلان‌ها و API» دسترسی آزمایشی یک‌ماهه را فعال کنید.

کلید API کجا نمایش داده می‌شود؟

پس از فعال‌سازی، کلید فقط یک‌بار در ناحیه کاربری نمایش داده می‌شود. آن را امن نگه دارید؛ بازتولید کلید، کلید قبلی را فوراً باطل می‌کند.

محدودیت تعداد درخواست چگونه است؟

سهمیه ماهانه به پلان وابسته است. مقدار باقی‌مانده در پاسخ v1 و Headerهای RateLimit اعلام می‌شود.

برای مصرف تجاری آماده‌اید؟

اگر به سهمیه بالاتر، پوشش مشخص بازار یا هماهنگی فنی نیاز دارید، جزئیات پروژه را بفرستید تا پیشنهاد متناسب دریافت کنید.

  • پیشنهاد متناسب با حجم مصرف
  • انتخاب بازارها و سطح دسترسی
  • بررسی نیازهای فنی و سازمانی
فقط قصد تست دارید؟ از ناحیه کاربری شروع کنید

درخواست پلن تجاری

این فرم برای پلان‌های پایه، حرفه‌ای و سازمانی است.

اطلاعات شما فقط برای پیگیری همین درخواست استفاده می‌شود.
درخواست شما ثبت شد؛ به‌زودی با شما تماس می‌گیریم.