شروع سریع API قیمت بازار ایران Servix

این راهنما کوتاه ترین مسیر از ساخت حساب تا دریافت اولین پاسخ JSON از API سرویکس است. برای آزمایش اتصال به کارت بانکی یا خرید پلن نیاز ندارید؛ هر حساب می تواند یک بار حساب تست محدود سه روزه را از داشبورد فعال کند.

پیش نیازها

• یک حساب کاربری Servix؛
• ابزاری مانند curl، Postman یا یک بک اند که بتواند هدر HTTP بفرستد؛
• نگهداری کلید API در متغیر محیطی یا secret manager، نه در کد عمومی و مرورگر.

گام ۱: ثبت نام و فعال سازی حساب تست

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

گام ۲: ساخت و نگهداری کلید API

در مسیر Profile > API Keys کلید را بسازید. مقدار کامل کلید فقط هنگام ایجاد یا نمایش مجاز در اختیار شما قرار می گیرد؛ همان لحظه آن را در محل امن ذخیره کنید. کلید را در URL، پیام پشتیبانی، مخزن عمومی یا کد جاوااسکریپت سمت کاربر قرار ندهید.

گام ۳: اولین درخواست

نماد USD_RLS قیمت دلار آمریکا در برابر ریال ایران است. مقدار کلید خود را جایگزین نمونه کنید:

curl -sS https://servix.cc/api/v1/assets/USD_RLS \
  -H "X-API-Key: pk_live_your_key_here"

در پاسخ موفق، فیلدهای code، name، slug، labelEn، labelFa، value و businessTime برمی گردند. businessTime زمان مربوط به خود قیمت است، نه زمان ارسال درخواست شما؛ برای نمایش تازگی داده آن را همراه value ذخیره کنید.

{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "value": "<protected-market-value>",
  "businessTime": "2026-04-13T10:24:00Z"
}

گام ۴: نماد و مسیر مناسب را انتخاب کنید

برای کشف کدهای معتبر، راهنمای نمادهای پشتیبانی شده را بخوانید. برای یک قیمت جاری به راهنمای قیمت جاری و برای روز یا بازه گذشته به راهنمای داده تاریخی بروید.

ابزارهای آماده

• فایل عمومی OpenAPI برای تولید کلاینت یا بررسی قرارداد؛
• مجموعه Postman سرویکس؛ پس از import فقط متغیر apiKey را با کلید حساب خود پر کنید؛
• راهنمای احراز هویت و نگهداری امن کلید.

مرحله بعد

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