مرجع API
ویجت آماده تابلو و نمودار
GET
https://data.zevix.ir/v1/widgetبدون برنامه‌نویسی: تابلوی قیمت و نمودار را با یک iframe در سایت خود بگذارید.
صفحه HTML سبک (بدون اسکریپت خارجی) با کارت‌های قیمت و نمودار. با پلن دارای ارسال زنده، اعداد خودشان زنده تغییر می‌کنند؛ در غیر این صورت هر دقیقه تازه می‌شوند.
برای ویجت یک کلید جدا بسازید و دامنه سایت را در «دامنه‌های مجاز» آن ثبت کنید: آن کلید فقط در همان سایت قاب می‌شود (frame-ancestors).
نیازمند پلن
ویجت (پلن حرفه‌ای و سازمانی)
پارامترها
| پارامتر | محل | نوع | توضیح |
|---|---|---|---|
keyالزامی | query | string | کلید ویجت |
symbolsاختیاری | query | string | نمادهای تابلو (پیش‌فرض ۶ نماد اول) — مثال: gold_18,coin_emami,usd |
chartاختیاری | query | string | نماد نمودار (پیش‌فرض اولین نماد) — مثال: gold_18 |
daysاختیاری | query | integer | بازه نمودار (پیش‌فرض ۷) — مثال: 30 |
themeاختیاری | query | light | dark | رنگ ویجت — مثال: dark |
پاسخ‌های خطا
| HTTP | کد | چه وقت | |
|---|---|---|---|
| 401 | api_key_required | هیچ‌کدام از X-API-Key، Authorization: Bearer یا api_key در درخواست نیست. | راه‌حل ← |
| 401 | invalid_api_key | کلید اشتباه تایپ شده، باطل شده یا وجود ندارد. | راه‌حل ← |
| 402 | subscription_expired | پلن فعالی برای حساب نیست (تمام شده یا هنوز نخریده‌اید). | راه‌حل ← |
| 403 | plan_feature_missing | ارسال زنده یا ویجت در پلن شما نیست. | راه‌حل ← |
| 403 | origin_not_allowed | کلید به دامنه‌های مشخصی محدود است و درخواست (یا قاب ویجت) از سایت دیگری است. | راه‌حل ← |
همه کدها و راه‌حل‌ها: کدهای وضعیت و خطا.
درخواست
<iframe src="https://data.zevix.ir/v1/widget?key=zxp_…&symbols=gold_18,coin_emami,usd&chart=gold_18"
width="100%" height="420" style="border:0" loading="lazy"></iframe>