# اتصال بازار والکس

محل ثبت کلید API و رابطه آن با داده‌های عمومی بازار.

وضعیت: پیاده‌سازی‌شده | مخاطب: مالک پنل و تیم اتصال بازار
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## کاربرد اتصال

کارت والکس در بخش اتصال‌ها برای تتر، تترگلد و نمادهای نفت، مس و نقره دیجیتال در نظر گرفته شده است. نمادهای معرفی‌شده USDT، XAUT، USOON، COPXON و SLVON و واحد بازار TMN هستند.

متن رابط تصریح می‌کند که قیمت، حجم، نمودار و سفارش‌های عمومی بازار به کلید نیاز ندارند. کلید ذخیره‌شده برای درخواست عمومی ارسال نمی‌شود.

## ثبت کلید

مالک کلید را در کادر رمزدار وارد و ذخیره می‌کند. ورودی پس از ذخیره پاک می‌شود و وضعیت حضور کلید نمایش داده می‌شود.

پاسخ تنظیمات فقط حضور کلید، نسخه و زمان تغییر دارد. مقدار کلید موجود بازگردانده نمی‌شود. قرارداد حفظ کلید با مقدار خالی را پشتیبانی می‌کند؛ رابط برای ذخیره کلید جدید ورودی غیرخالی می‌خواهد.

## نگهداری و تغییرات

تنظیمات از ثبت‌خانه سرویس‌ها و مخزن امن کلیدها استفاده می‌کنند. هویت سرویس و مقصد والکس در کد مشخص است و فرم مقصد دلخواه انتخاب نمی‌کند.

ذخیره نسخه‌دار است و در تغییر هم‌زمان تازه‌سازی لازم می‌شود. کلید در فهرست عمومی دارایی‌ها یا پاسخ تنظیمات منتشر نمی‌شود.

## قرارداد مدیریت

کلید باید رشته معتبر و نسخه عدد صحیح نامنفی باشد. سقف بدنه ۱۲٬۰۰۰ بایت است. نبود جلسه ۴۰۱، نقش غیرمالک ۴۰۳ و اختلاف نسخه از مسیر خطای تنظیمات گزارش می‌شود.

| روش و مسیر | ورودی | پاسخ |
| --- | --- | --- |
| GET /api/integrations/wallex | جلسه مالک | {hasKey, version, updatedAt} |
| PUT /api/integrations/wallex | {secret, version} و مبدأ همان پنل | وضعیت ذخیره بدون مقدار کلید |

## نرخ تبدیل و مرز عملیات

نرخ تبدیل ریال و دلار در کارت مستقل تنظیم می‌شود. ذخیره کلید، سیاست نرخ تبدیل را تغییر نمی‌دهد.

این کارت مسیر خرید، فروش یا برداشت ندارد. دریافت داده عمومی و ثبت امن کلید دو قابلیت جدا هستند؛ حضور کلید ذخیره‌شده به معنی بررسی موفق اعتبار آن نیست.

- [مستندات رسمی والکس](https://developers.wallex.ir/docs)

## مراجع پیاده‌سازی

- planck-admin/components/wallex-settings.tsx
- planck-admin/lib/wallex-settings.ts
- planck-admin/app/api/integrations/wallex/route.ts
- planck-admin/tests/wallex-settings.test.mjs