# اتصال و بررسی کلید Ondo

ذخیره امن کلید و بررسی دسترسی به فهرست دارایی‌های Ondo.

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

## قابلیت پیاده‌سازی‌شده

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

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

## بررسی پیش از ذخیره

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

سرور فهرست متادیتای دارایی‌ها را از نشانی ثابت رسمی با هدر x-api-key می‌خواند. خروجی فقط تعداد نمادهای یکتا و زمان بررسی است؛ قیمت قطعی یا معامله‌ای ایجاد نمی‌شود.

## ثبت در مخزن امن

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

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

## مسیرها و نتیجه‌ها

کلید نامعتبر یا فاقد مجوز داده در بررسی، وضعیت ۴۲۲ می‌گیرد. پاسخ نامعتبر سرویس ۵۰۲ و قطع ارتباط یا محدودیت درخواست ۵۰۳ است. متن خام خطای ارائه‌دهنده منتشر نمی‌شود.

| روش و مسیر | قرارداد |
| --- | --- |
| GET /api/integrations/ondo | پاسخ {hasKey, version, updatedAt} |
| PUT /api/integrations/ondo | ورودی {secret, version}؛ مالک و همان مبدأ |
| POST /api/integrations/ondo/check | ورودی {secret}؛ پاسخ {assetCount, checkedAt} |

## آمادگی و حدود اتصال

درخواست بررسی به فهرست رسمی محدود است، زمان انتظار ۱۰ ثانیه دارد و حداکثر ۲ مگابایت پاسخ خوانده می‌شود. ساختار نماد، ticker و tags قبل از موفقیت بررسی می‌شود.

عملیات زنده به کلید معتبر نیاز دارد و ذخیره به آماده بودن ثبت‌خانه و مخزن امن پایگاه داده وابسته است. این بخش سیاست نرخ ریال را تغییر نمی‌دهد.

- [راهنمای رسمی API در Ondo](https://docs.ondo.finance/api-reference/overview)
- [احراز دسترسی و راه‌اندازی](https://docs.ondo.finance/api-reference/quickstart)

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

- planck-admin/components/ondo-settings.tsx
- planck-admin/lib/ondo-settings.ts
- planck-admin/lib/ondo-server.ts
- planck-admin/app/api/integrations/ondo/route.ts
- planck-admin/app/api/integrations/ondo/check/route.ts
- planck-admin/ONDO_SETUP.md
- planck-admin/tests/ondo-settings.test.mjs