Маалымат алмашуу регламенти
Портал банктар жана окуу жайлар менен билдирүү алмашуучу эрежелер. Бөлүм келишимдерди сүрөттөйт; чакырыктардын техникалык деталдары — API документациясында.
Банктардын жана мамлекеттик системалардын контурлары этап-этабы менен туташтырылат. Контур туташтырылмайынча алмашуу куму аянтчада жүрөт — ар бир контурдун абалы «Куму аянтча» бетинде көрсөтүлгөн.
1Алмашуунун катышуучулары
- Портал — арыздарды жана окуу статустарын жөнөтөт, банктардын чечимдерин жана төлөм ырастоолорун кабыл алат.
- Банк — арызды кабыл алат, чечим кайтарат, берүү жана которуу боюнча отчёт берет.
- Окуу жай — каражаттын түшкөнүн ырастайт жана карыз алуучунун окуу статусун берет.
- Мамлекеттик системалар — идентификация үчүн «Түндүк» жана окуу маалыматы үчүн Bilim.
2Банкка эмне жөнөтүлөт
Арыз тууралуу билдирүүнүн курамы жабык жана арыз ээсинин макулдугунда саналгандар менен чектелген: арыздын идентификатору жана номери, ПИН жана аты-жөнү, окуу жайдын коду жана аталышы, адистик, курс, контракттын суммасы, суралган сумма жана окуу жайдын эсеп реквизиттери.
Бул тизмеден тышкары эч нерсе банкка берилбейт — эмне баа, эмне дарек, эмне арыз ээси тууралуу башка маалымат.
3Операциялардын бир жолулугу
Ар бир билдирүү идемпотенттик ачкыч менен коштолот. Ошол эле билдирүүнү кайра жеткирүү экинчи арызды жана экинчи кредитти түзбөйт: алуучу биринчи иштетүүнүн жыйынтыгын кайтарууга милдеттүү.
Банктардын кирүүчү окуялары окуянын идентификатору боюнча айырмаланат: кайталанган окуя ырасталат, бирок кайра иштетилбейт.
4Билдирүүлөрдүн колтамгасы
Банктардын кирүүчү вебхуктары HMAC-SHA256 алгоритми боюнча кол коюлат, колтамга аталыш аркылуу берилет. Колтамга сурамдын чийки денеси боюнча, аны талдаганга чейин эсептелет: кайра чогултулган JSON башка байттарды жана башка колтамганы берет.
Кирүү реквизиттери банкка берилет жана берүүдө бир жолу гана көрсөтүлөт. Сырды алмаштыруу кардардын идентификаторун өзгөртпөйт.
5Статустар жана мөөнөттөр
Арыздын статустарынын жыйындысы жабык, алардын ортосундагы өтүүлөр аныкталган жана текшерилет: жол берилбеген өтүү тууралуу билдирүү четке кагылат.
Арызды кароонун мөөнөтүн банк өзү шарттарында жарыялайт. Өзү жарыялаган мөөнөттү бузуу катталат жана министрликке көрүнөт.
Каражатты окуу жайга которуу мөөнөтү банк менен окуу жайдын ортосундагы келишим менен белгиленет жана банктын шарттарында жарыяланат. Карыз алуучунун окуу статусу ай сайын берилет.
6Үзгүлтүктөр жана кайталоолор
Жеткирилбеген билдирүү кезекке кайтып, өсүүчү аралыктар менен кайталанат. Бардык аракеттерден кийин жеткирилбей калган билдирүү өзүнчө кезекке түшөт жана жоголбойт.
Каталар классификацияланган: коддордун, алардын себептеринин жана алуучу эмне кылышы керектигинин тизмеси өзүнчө API методу менен берилет.
7Алмашуу журналы
Жөнөтүлгөн жана кабыл алынган ар бир билдирүү жазылат: убакыт, катышуучу, түрү, идемпотенттик ачкыч, жыйынтык. Журнал катышуучуга өз билдирүүлөрү боюнча, министрликке толугу менен жеткиликтүү.
8Келишимди өзгөртүү
API'нин артка шайкеш келбеген өзгөрүүлөрү жолдун жаңы версиясы менен чыгат. Милдеттүү эмес талааны кошуу алмашууну токтотуу үчүн негиз болбойт: алуучу тааныш эмес талааларды көрмөксөнгө салууга милдеттүү.