# تنظیم سرویس‌های استعلام

ثبت ارائه‌دهنده و کلید و تفاوت تنظیم سرویس با آماده بودن اجرای آن.

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

## فهرست سرویس‌ها

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

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

## ثبت مشخصات و کلید

فرم عنوان، شناسه، نوع استعلام، ارائه‌دهنده، نشانی و کادر رمزدار کلید دارد. شناسه سرویس موجود ثابت است؛ نوع از هویت، مالکیت موبایل، مالکیت بانکی یا سایر انتخاب می‌شود.

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

نشانی باید HTTPS و بدون نام کاربری، رمز، پارامتر یا بخش اضافی باشد. کلید فقط در فیلد اختصاصی قرار می‌گیرد.

## اتصال‌های شناخته‌شده

| سرویس | کاربرد و وضعیت |
| --- | --- |
| ثبت‌احوال شبانیک | تطبیق مشخصات و تاریخ تولد؛ راهنما و مسیر اجرای هویتی موجود |
| شاهکار شبانیک | تطبیق موبایل تأییدشده و کد ملی؛ راهنما و مسیر اجرا موجود |
| تطبیق شبا با کد ملی | مالکیت حساب بانکی؛ انتخاب سرویس آماده و اجرای بررسی |
| تبدیل کارت به حساب و شبا | راهنمای کلید برای جریان ثبت حساب بانکی |
| سایر سرویس‌ها | قابل ثبت در فهرست؛ ثبت کلید به‌تنهایی اتصال اجرایی ایجاد نمی‌کند |

## ذخیره تنظیمات و اجرای استعلام

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

مسیر اجرا شناسه استعلام و سرویس را می‌پذیرد؛ اطلاعات لازم از پرونده مرتبط توسط سرویس پایگاه داده تأمین می‌شود. نتیجه مثبت، عدم تطبیق و خطای سرویس جدا نمایش داده می‌شوند.

## پیش‌نیازهای راه‌اندازی

- مهاجرت و سیاست‌های دسترسی سرویس باید نصب باشد.
- کلید و مجوز هر محصول ارائه‌دهنده جداگانه تأمین می‌شود.
- تغییر ارائه‌دهنده به قرارداد سازگار نیاز دارد؛ وارد کردن URL به‌تنهایی اجرای دلخواه ایجاد نمی‌کند.
- در نبود تابع اجرایی پایگاه داده، API آماده نبودن سرویس را اعلام می‌کند.

> دامنه بررسی: برای این مستند هیچ استعلام واقعی ارسال نشده و وضعیت زنده کلیدها بررسی نشده است.

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

- planck-admin/components/inquiry-settings.tsx
- planck-admin/lib/inquiries.ts
- planck-admin/lib/inquiry-catalog.ts
- planck-admin/app/api/inquiries/route.ts
- planck-admin/app/api/inquiries/run/route.ts
- planck-admin/SHABANIC_IDENTITY_INQUIRIES.md