پلانکقابلیت پیاده‌سازی‌شده
کارت 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 قبل از موفقیت بررسی می‌شود.
عملیات زنده به کلید معتبر نیاز دارد و ذخیره به آماده بودن ثبت‌خانه و مخزن امن پایگاه داده وابسته است. این بخش سیاست نرخ ریال را تغییر نمی‌دهد.