نسخه ۱.۰.۲ فعال

اعتبارسنجی بانکی

این سرویس با بررسی سوابق بانکی، چک‌های برگشتی، تسهیلات دریافتی و خوش‌حسابی مشتری در شبکه بانکی کشور، یک نمره اعتباری دقیق ارائه می‌دهد. ایده‌آل برای لندتک‌ها و پلتفرم‌های اعتباری.

linkنقطه اتصال (Endpoint)

                            POST
                            https://api.api360.ir/v1/credit/score
                        

هدرهای احراز هویت

کلید	مقدار	توضیحات
Authorization	Bearer {API_KEY}	کلید اختصاصی پنل کاربری
X-API-KEY	YOUR_UNIQUE_KEY	کلید شناسایی اپلیکیشن

پارامترهای ورودی (Body)

پارامتر	نوع	الزامی	توضیحات
nationalCode	String	بله	کد ملی ۱۰ رقمی معتبر
mobile	String	بله	شماره موبایل منطبق
consent	Boolean	خیر	رضایت‌نامه کاربر

تعرفه سرویس

محاسبه به ازای هر فراخوانی موفق

۱,۵۰۰ تومان

نمونه درخواست JSON

{
  "nationalCode": "0012345678",
  "mobile": "09123456789",
  "consent": true
}

پاسخ موفق (200 OK)

{
  "success": true,
  "data": {
    "creditScore": 720,
    "grade": "A-",
    "lastUpdate": "2023-10-15T10:30:00Z",
    "summary": {
      "activeLoans": 2,
      "returnedChecks": 0,
      "status": "Healthy"
    }
  }
}

خطاهای احتمالی

{
  "success": false,
  "error": {
    "code": "INVALID_NATIONAL_ID",
    "message": "کد ملی وارد شده صحیح نمی‌باشد",
    "requestId": "req_88a91c"
  }
}