مستندات فنی «استعلام صاحبان امضا»

اندپوینت و دسترسی استعلام صاحبان امضا

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

Scope: kyb:authorized-signatories:get

Grant type: client_credentials

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

معرفی استعلام صاحبان امضا

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

ورودی و خروجی استعلام صاحبان امضا

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

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

فیلدهای مهم پاسخ: شماره آگهی روزنامه رسمی، اسناد مجاز برای امضا، متن کامل مورد امضا، تاریخ چاپ روزنامه رسمی، تاریخ نامه ثبت، تاریخ آخرین تغییر روزنامه رسمی، عنوان شرکت، دارندگان حق امضا.

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

کاربرد فنی استعلام صاحبان امضا

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

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

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

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

عملیات مرتبط با استعلام صاحبان امضا

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