API va platforma hodisalari

Xodim interfeysda qiladigan hamma narsa API orqali mavjud. Hamkor kanallari, qarz oluvchi sayti va ichki servislar oʻsha shartnomalar bilan ishlaydi.

Kirish va sarlavhalar

Soʻrov aniq tashkilotga va aniq lokalga yoʻnaltiriladi. Kalit kirish sohalari bilan beriladi, ishni toʻxtatmasdan qayta chiqariladi va bekor qilinishi mumkin.

API hujjatlari

Organization-Id: Tashkilotni aniqlaydi. Ijarachiga alohida baza rejimida u boʻyicha ulanish tanlanadi.
Language-Code: Javob lokali: maʼlumotnomalar, holat nomlari va hujjat matnlari shu tilda qaytariladi.
X-Api-Key: Hamkor integratsiyasi kaliti. Kirish sohasi mavjud metodlar toʻplamini cheklaydi.
Idempotency-Key: Pul operatsiyalari uchun takrorlash kaliti: qayta yuborish ikkinchi tranzaksiya yaratmaydi.

API boʻlimlari

Metodlar predmet sohalari boʻyicha guruhlangan va platforma tuzilishini takrorlaydi.

Arizalar

Ariza yaratish, tekshiruv qadamlari, hujjatlar va anderrayting qarorlari.

/applications

Mijozlar

Profil, identifikatorlar, hujjatlar, roziliklar va bank rekvizitlari.

/customers

Shartnomalar

Toʻlov jadvali, hisoblanmalar, toʻlovlar va qarz komponentlari boʻyicha taqsimlash.

/loans

Skoring

Modellar, qoidalar, belgilar va taʼsir qilgan omillar roʻyxati bor natijalar.

/scoring

Komplayens va AML

Reyestrlar boʻyicha tekshiruvlar, ogohlantirishlar, risk profillari va regulyatorga xabarlar.

/compliance, /aml

Undirish

Ishlar, aloqalar, toʻlash vaʼdalari, sud ishi va sessiya partiyalari.

/collection

Moliyalashtirish

Investorlar, jalb qilish shartnomalari, obligatsiya seriyalari va toʻlovlar.

/funding

Hisobot

Shakl shablonlari, qoralamalar, tekshirish va kerakli formatda yuklash.

/reporting, /tax-reporting

Mijoz kabineti

Qarz oluvchi sayti va ilovasi uchun ochiq metodlar.

/public/customer

Hodisalar va vebxuklar

Shartnoma boʻyicha oʻzgarishlar chiquvchi navbat orqali tashqariga eʼlon qilinadi. Yetkazish oʻsuvchi interval bilan takrorlashlar orqali kafolatlanadi, yetkazilmagan xabarlar esa yoʻqolmasdan alohida navbatga tushadi.

Hodisalarga obuna
Manzil, hodisalar toʻplami va imzo siri tashkilot uchun sozlanadi.
Yetkazish jurnali
Har bir urinish boʻyicha javob kodi, tanasi va keyingi takrorlash vaqti koʻrinadi.
Byurolarga hodisalar
Shartnoma va kredit liniyasining oʻttiz uch hodisa turi kredit byurolariga yuboriladi.
Buxgalteriyaga hodisalar
Oʻttiz uch hodisa turi hisob tizimiga HTTP yoki fayl almashinuvi orqali yuboriladi.

Muhit va cheklovlar

Haqiqiy ulanishgacha tashqi provayderlar zaglushka rejimida ishlaydi: tizim toʻliq javob beradi, lekin pul harakatlanmaydi va haqiqiy tekshiruvlar bajarilmaydi.

Tashqi xizmatlarga har bir murojaat soʻrov va javob matni bilan birga jurnalga yoziladi, API kalitlari esa faqat xesh koʻrinishida saqlanadi.

Soʻrov namunasi

GET /Applications/GetApplications?Offset=0&Count=20
Organization-Id: 42
Language-Code: ru
X-Api-Key: ••••••••

API hujjatlari Materiallar va yoʻriqnomalar

Javob formati: Yagona qobiqdagi JSON: kod, muvaffaqiyat belgisi, xato matni va foydali yuk.
Sahifalash: Server tomonida. Siljish va soni soʻrovda beriladi, javobda yozuvlarning umumiy soni boʻladi.
Idempotentlik: Pul operatsiyalari va jadval oʻzgarishlari uchun majburiy.
Lokalizatsiya: Olti til. Lokal tashkilot sozlamasi bilan emas, soʻrov sarlavhasi bilan aniqlanadi.
Sinov stendi: Oʻsha shartnomalari va provayderlar oʻrniga zaglushkalari bor alohida kontur.
Versiyalash: Mos kelmaydigan oʻzgarishlar alohida versiya bilan chiqadi, eskisi kuzatib borish shartnomasi boʻyicha ishlashda davom etadi.

Tez-tez beriladigan savollar

Interfeyssiz faqat API orqali ishlash mumkinmi

Ha. Xodim interfeysi oʻsha API dan foydalanadi, shuning uchun interfeysda mavjud ssenariy kalitning kirish sohasi doirasida tashqi mijozga ham mavjud.

Hamkor autentifikatsiyasi qanday tuzilgan

Hamkor cheklangan kirish sohasi bor kalit oladi. Kalit xesh koʻrinishida saqlanadi, toʻxtatishsiz qayta chiqariladi, barcha chaqiruvlar esa soʻrov va javob tanasi bilan tashqi murojaatlar jurnaliga tushadi.

Toʻlovni qayta yuborganda nima boʻladi

Pul operatsiyalari takrorlash kalitini qabul qiladi. Oʻsha kalit bilan takrorlangan soʻrov birinchi operatsiya natijasini qaytaradi va ikkinchi tranzaksiya yaratmaydi.

Muddat oʻtishi yoki toʻlash haqida bildirishnomani qanday olish mumkin

Hodisalarga obuna orqali. Manzil, hodisalar toʻplami va imzo siri koʻrsatiladi. Har bir yetkazish urinishi qayd etiladi, muvaffaqiyatsizlari oʻsuvchi interval bilan takrorlanadi.