مستندات فنی «استعلام گواهینامه و وضعیت»

اندپوینت و دسترسی استعلام گواهینامه و وضعیت

این صفحه مستندات فنی فراخوانی POST /kyc/v2/clients/{clientId}/licenseCheckInquiry است.

Scope: kyc:cc-license-check-inquiry:post

Grant type: client_credentials

دسته‌بندی OpenAPI: استعلام خودرو. شناسه عملیات: kycLicenseCheckInquiryPost.

معرفی استعلام گواهینامه و وضعیت

سرویس «استعلام گواهینامه و وضعیت» (KYC) در دسته استعلام خودرو و پلاک فینوتک. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. بدون رضایت پیامکی کاربر و با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

ورودی و خروجی استعلام گواهینامه و وضعیت

ورودی‌های اصلی: شناسه کلاینت، کد پیگیری، کدملی، شماره موبایل.

فیلدهای مهم پاسخ: اطلاعات گواهینامه‌ها شامل:، وضعیت استعلام گواهینامه شامل:.

جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.

کاربرد فنی استعلام گواهینامه و وضعیت

سرویس «استعلام گواهینامه و وضعیت» (KYC) در دسته استعلام خودرو و پلاک فینوتک. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. بدون رضایت پیامکی کاربر و با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.

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

برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «استعلام گواهینامه و وضعیت» مراجعه کنید.

عملیات مرتبط با استعلام گواهینامه و وضعیت

• استعلام خلافی خودرو — GET /billing/v2/clients/{clientId}/drivingOffense
• استعلام خلافی خودرو — GET /billing/v2/clients/{clientId}/drivingOffense
• استعلام نمره منفی گواهینامه — GET /billing/v2/clients/{clientId}/negativeScore
• استعلام نمره منفی گواهینامه — GET /billing/v2/clients/{clientId}/negativeScore
• استعلام خلافی موتور — GET /billing/v2/clients/{clientId}/ridingOffense