مستندات فنی «استعلام مجوزهای شرکت»

اندپوینت و دسترسی استعلام مجوزهای شرکت

این صفحه مستندات فنی فراخوانی GET /kyb/v2/clients/{clientId}/companyLicenses است.

Scope: kyb:company-licenses:get

Grant type: client_credentials

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

معرفی استعلام مجوزهای شرکت

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

ورودی و خروجی استعلام مجوزهای شرکت

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

پارامترهای اختیاری متداول: کد پیگیری.

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

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

کاربرد فنی استعلام مجوزهای شرکت

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

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

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

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

عملیات مرتبط با استعلام مجوزهای شرکت

• استعلام صاحبان امضا — GET /kyb/v2/clients/{clientId}/authorizedSignatories
• استعلام صاحبان امضا — GET /kyb/v2/clients/{clientId}/authorizedSignatories
• استعلام اعضای هیئت مدیره — GET /kyb/v2/clients/{clientId}/boardMembers
• استعلام اعضای هیئت مدیره — GET /kyb/v2/clients/{clientId}/boardMembers
• استعلام اطلاعات شرکت با شناسه ملی — GET /kyb/v2/clients/{clientId}/companyInfo