1. Mobile SDK
RSID docs
Uzbek
  • English
  • Russian
  • Uzbek
  • Umumiy tushunchalar
  • Web SDK
    • Integratsiya qo'llanmasi
    • Avtorizatsiya (sign-in)
      POST
    • Tokenni yangilash (refresh)
      POST
    • Sessiya yaratish
      POST
    • Foydalanuvchi ma'lumotlarini olish
      GET
  • Mobile SDK
    • Integratsiya qo'llanmasi
    • Avtorizatsiya (sign-in)
      POST
    • Tokenni yangilash (refresh)
      POST
    • Sessiya yaratish
      POST
    • Foydalanuvchi ma'lumotlarini olish
      GET
  • Server orqali (ma'lumotlar bilan)
    • Integratsiya qo'llanmasi
    • Avtorizatsiya (sign-in)
      POST
    • Tokenni yangilash (refresh)
      POST
    • 1-variant — fotosuratni pasport fotosurati bilan taqqoslash
      POST
    • 2-variant — ikki fotosuratni fuqaro ma'lumotlari bilan taqqoslash
      POST
    • 3-variant — ikki fotosuratni fuqaro ma'lumotlarisiz taqqoslash
      POST
    • Natijani olish
      GET
  • Server orqali (ma'lumotlarsiz)
    • Integratsiya qo'llanmasi
    • Avtorizatsiya (sign-in)
      POST
    • Tokenni yangilash (refresh)
      POST
    • 1-variant — fotosuratni pasport fotosurati bilan taqqoslash
      POST
    • 2-variant — ikki fotosuratni fuqaro ma'lumotlari bilan taqqoslash
      POST
    • 3-variant — ikki fotosuratni fuqaro ma'lumotlarisiz taqqoslash
      POST
  • Avtorizatsiya va QR orqali imzolash
    • RS-ID orqali kirish (OAuth2)
    • QR-kod orqali imzolash
    • Kod bo'yicha foydalanuvchi ma'lumotlarini olish
      POST
    • Avtorizatsiya (sign-in)
      POST
    • Tokenni yangilash (refresh)
      POST
    • QR-token yaratish
      POST
    • qr_id bo'yicha QR-token holati
      GET
    • external_id bo'yicha QR-token holati
      GET
  • Schemas
    • ErrorResponse
    • AuthCodeRequest
    • ClientCredentials
    • Token
    • UserInfo
    • TokenResponseEnvelope
    • DocumentInfo
    • Signer
    • StringResponseEnvelope
    • ContactInfo
    • CallbackEvent
    • UserProfile
    • QrTokenCreateRequest
    • PhotoItem
    • Address
    • UserProfileResponseEnvelope
    • AdditionalParams
    • WebSessionCreateRequest
    • QrToken
    • UserProfileResponse
    • CompareFaceRequest
    • UserResponseEnvelope
    • CompareImagesWithInfoRequest
    • QrTokenResponseEnvelope
    • CompareImagesRequest
    • SignCallback
    • ComparisonResult
    • MobileSessionCreateRequest
    • ComparisonResultEnvelope
  1. Mobile SDK

Integratsiya qo'llanmasi

Mobile SDK bilan integratsiya#

1. RS-ID Mobile SDK nima#

RS-ID Mobile SDK mobil ilovangizga (Android / iOS) qarshingizdagi inson haqiqiy, tirik ekanini va u o'zini kim deb ko'rsatayotgan bo'lsa, aynan o'sha ekanini yuz va O'zbekiston Respublikasi davlat reyestri orqali tasdiqlash imkonini beradi.
Kamera, "tiriklik" tekshiruvi yoki yuzlarni taqqoslash mantiqini ishlab chiqishingiz shart emas. Backendingiz sessiya yaratadi, ilovangiz RS-ID SDK ni (ilovangizga qo'shilgan nativ kutubxona) ishga tushiradi, foydalanuvchi selfi oladi, RS-ID esa:
1.
selfida foto, ekran yoki niqob emas, tirik inson ekanini tekshiradi (anti-spufing);
2.
davlat reyestridan fuqaroning rasmiy pasport fotosurati va ma'lumotlarini oladi;
3.
selfini pasport fotosurati bilan taqqoslaydi;
4.
natijani ilovangizga qaytaradi va backendingizga tasdiqlangan fuqaro profilini beradi.

Foydalanish holatlari#

HolatMisol
Masofadan mijozni identifikatsiya qilish (KYC)Bank, mikromoliya yoki sug'urta ilovasi ofisga kelmasdan hisob ochadi.
Muhim amal oldidan shaxsni tasdiqlashYirik o'tkazma, parolni tiklash yoki telefon raqamini almashtirishdan oldin akkaunt egasini tasdiqlash.
Onlayn shartnoma imzolashIlovada kredit yoki ijara shartnomasini aynan shu fuqaro imzolayotganini tekshirish.
Yosh / shaxsni tekshirishYoshni yoki haqiqiy shaxsni tasdiqlashi kerak bo'lgan marketpleys, telekom, o'yin yoki yetkazib berish ilovalari.
Ro'yxatdan o'tishni avtomatik to'ldirishFoydalanuvchi faqat selfi oladi; ro'yxatdan o'tish formasi tasdiqlangan F.I.Sh., hujjat va tug'ilgan sana bilan to'ldiriladi.
Qayta tekshirishQaytgan foydalanuvchi oldingi sessiyasidagi ma'lumotlar bo'yicha, ularni qayta kiritmasdan, yana tekshiriladi.

2. Atamalar#

AtamaKim
Mijoz (Client)RS-ID'ni integratsiya qilayotgan kompaniya (siz). RS-ID'da ro'yxatdan o'tgan va Mobile SDK uchun client_id / client_secret olgan. Mijoz backendi (RS-ID API ni chaqiradi) va mijoz ilovasini (ichida RS-ID SDK bo'lgan Android / iOS ilovangiz) o'z ichiga oladi.
FoydalanuvchiIdentifikatsiya qilinayotgan inson — sizning mijozingiz, O'zbekiston fuqarosi.
ServerRS-ID serveri: Mobile SDK API (<rsid_base_url>).
RS-ID SDKMijoz ilovasiga qo'shilgan nativ RS-ID kutubxonasi. RS-ID ekranlarini (ma'lumot kiritish, kamera) ko'rsatadi va selfini serverga yuboradi.
SessiyaMijoz backendi yaratgan bitta identifikatsiya urinishi. session_id (UUID) bilan aniqlanadi. Amal qilish muddati va urinishlar soni cheklangan.
JSHSHIR (PINFL)Jismoniy shaxsning shaxsiy identifikatsiya raqami — 14 ta raqam.
Hujjat raqami (id_number)Pasport yoki ID-karta seriyasi va raqami, masalan AA1234567.

3. Integratsiya turi — nativ SDK#

RS-ID ekranlari RS-ID SDK orqali ilovangiz ichida ishlaydi. Foydalanuvchi ilovani tark etmaydi.
1.
RS-ID SDK ni qo'shing Android / iOS loyihangizga. Paket va o'rnatish bo'yicha yo'riqnomani RS-ID hisob ma'lumotlari bilan birga taqdim etadi.
2.
Ilovada kameraga ruxsat bering:
Android — AndroidManifest.xml da android.permission.CAMERA;
iOS — Info.plist da NSCameraUsageDescription (kamera so'ralganda foydalanuvchiga ko'rsatiladigan matn).
3.
SDK ni ishga tushiring backendingizdan olingan session_id bilan (7.4).
4.
Natijani qayta ishlang — SDK ilovangizga qaytaradigan natija: muvaffaqiyat, muvaffaqiyatsizlik yoki foydalanuvchi tomonidan bekor qilish (7.6).
5.
Natijani backendingizda tasdiqlang GET /v1/user/{session_id} orqali (7.7).
Web SDK dan farqli ravishda, Mobile SDK sessiyalari IP manzilga bog'lanmaydi va redirect_url yo'q — natija SDK dan ilovangizga qaytadi.

4. Integratsiya sxemasi#

integration-flow-mobile-sdk.png

5. Muhitlar#

MuhitAPI bazaviy URL
Stage (test)https://sdk.stage.rsid.uz/mobile/api
Productionhttps://sdk.rsid.uz/mobile/api
Stage va production uchun turli client_id / client_secret ishlatiladi. Mobile SDK hisob ma'lumotlari Web SDK hisob ma'lumotlaridan farq qiladi — Web SDK mijozi mobil sessiyalar yarata olmaydi (-1002).

6. Umumiy qoidalar#

Javob formati#

Barcha API javoblari bir xil tuzilishga ega:
{ "data": { }, "code": 0, "message": "Success" }
MaydonTuriTavsif
codeinteger0 — muvaffaqiyat. Boshqa har qanday qiymat — xato (xatolar jadvaliga qarang). Faqat HTTP-statusni emas, har doim code ni tekshiring.
messagestringSo'rov tilidagi matn (uz / ru / en). Uni dasturiy tahlil qilmang.
dataanyJavob ma'lumotlari. Xato bo'lganda yo'q.

Sarlavhalar (Headers)#

SarlavhaQiymatQayerda ishlatiladi
Content-Typeapplication/jsonBarcha POST so'rovlar
AuthorizationBearer {access_token}sign-in va refresh dan tashqari barcha so'rovlar
Accept-Languageuz / ru / enIxtiyoriy — message tili
Xavfsizlik. client_secret faqat mijoz backendida saqlanishi kerak. Uni hech qachon ilovaga qo'ymang — ilova fayllarini ajratib olish mumkin. sign-in va sessiya yaratish ni faqat backendingizdan chaqiring.

7. API tavsifi#

7.1 Avtorizatsiya (Sign in)#

Mijoz hisob ma'lumotlarini kirish tokeniga almashtiradi.
Metod - POST
Endpoint - {base_url}/v1/auth/sign-in — Authorization sarlavhasisiz
Content-Type (sarlavha) - application/json

So'rov tanasi
MaydonTuriMajburiyUzunlik / formatTavsif
client_idstringHaBo'sh emas; raqam bilan boshlanmaydiRS-ID bergan Mobile SDK mijoz identifikatori.
client_secretstringHaBo'sh emasRS-ID bergan mijoz siri.
{
  "client_id": "mobile-sdk-client",
  "client_secret": "s3cr3t-value"
}
Javob
MaydonTuriTavsif
data.access_tokenstring (JWT)Authorization: Bearer sarlavhasi uchun token.
data.token_typestringHar doim Bearer.
data.expires_inintegerTokenning amal qilish muddati, soniyalarda.
data.scopestringBerilgan huquqlar, bo'sh joy bilan ajratilgan.
data.refresh_tokenstring (JWT)Hisob ma'lumotlarini qayta yubormasdan yangi access_token olish uchun token.
codeintegerMuvaffaqiyatda 0.
messagestringNatija matni.
{
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "scope": "read write",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  "code": 0,
  "message": "Success"
}
Har bir sessiya uchun qayta avtorizatsiya qilmang — access_token muddati tugaguncha undan qayta foydalaning.

7.2 Tokenni yangilash (Refresh token)#

refresh_token orqali qayta avtorizatsiyasiz yangi access_token beradi. access_token muddati tugaganda (expires_in soniyadan keyin) chaqiring.
Metod - POST
Endpoint - {base_url}/v1/auth/refresh?token={refresh_token} — Authorization sarlavhasisiz.
Content-Type (sarlavha) - application/json

Query-parametrlar
MaydonTuriMajburiyUzunlik / formatTavsif
tokenstringHaJWTAvtorizatsiyadan (7.1) yoki oldingi yangilash javobidan olingan refresh_token.
So'rov tanasi
MaydonTuriMajburiyUzunlik / formatTavsif
client_idstringHaBo'sh emas; raqam bilan boshlanmaydiRS-ID bergan Mobile SDK mijoz identifikatori.
client_secretstringHaBo'sh emasRS-ID bergan mijoz siri.
{
  "client_id": "mobile-sdk-client",
  "client_secret": "s3cr3t-value"
}
Javob
MaydonTuriTavsif
data.access_tokenstring (JWT)Authorization: Bearer sarlavhasi uchun yangi token.
data.token_typestringHar doim Bearer.
data.expires_inintegerTokenning amal qilish muddati, soniyalarda.
data.scopestringBerilgan huquqlar, bo'sh joy bilan ajratilgan.
data.refresh_tokenstring (JWT)Keyingi yangilash uchun yangi refresh-token.
codeintegerMuvaffaqiyatda 0.
messagestringNatija matni.
{
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "scope": "read write",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  "code": 0,
  "message": "Success"
}
Agar refresh-token muddati tugagan yoki yaroqsiz bo'lsa, qayta avtorizatsiyadan o'ting (7.1).

7.3 Sessiya yaratish#

Bitta foydalanuvchi uchun identifikatsiya sessiyasini yaratadi. Sessiya mijozingizga tegishli: undan faqat mijozingiz tokeni bilan yuborilgan so'rovlar foydalana oladi.
Metod - POST
Endpoint - {base_url}/v1/sessions
Authorization (sarlavha) - Bearer {access_token}
Content-Type (sarlavha) - application/json

So'rov tanasi
MaydonTuriMajburiyUzunlik / formatTavsif
client_typestring (enum)HaMOBILEIntegratsiya kanali. Mobile SDK uchun har doim MOBILE.
user_infoobjectYo'q—Fuqaro ma'lumotlari. user_info bilan sessiya yaratish uchun yuboring; user_info siz sessiya uchun yubormang.
user_info.pinflstringShartliAniq 14 ta raqamJSHSHIR. Yoki pinfl, yoki id_number yuboring, ikkalasini emas.
user_info.id_numberstringShartli9 belgi: 2 ta harf + 7 ta raqam, masalan AA1234567Pasport / ID-karta raqami. Yoki pinfl, yoki id_number yuboring, ikkalasini emas.
user_info.birth_datestringuser_info yuborilsa, hadd.MM.yyyyTug'ilgan sana. Foydalanuvchi kamida 16 yoshda bo'lishi kerak.
session_idstringYo'qUUID, 36 belgiXuddi shu foydalanuvchi uchun mijozingizning oldingi sessiyasi. Yangi sessiya fuqaro ma'lumotlarini undan oladi, foydalanuvchi ularni qayta kiritmaydi. user_info yuborilsa, e'tiborga olinmaydi.
external_idstringYo'q—Sessiyani o'z ma'lumotlaringiz bilan bog'lash uchun o'z identifikatoringiz (buyurtma, ariza yoki mijoz). Tasodifiy uuid tavsiya etiladi.
retry_countintegerYo'q> 0Maksimal urinishlar soni. Yuborilmasa, 0 yoki tizim maksimumidan katta bo'lsa, tizim maksimumi ishlatiladi.
thresholdnumberYo'q0.0 – 1.0O'tish uchun yuzlar o'xshashligining minimal chegarasi. Standart qiymat 0.5. Quyidagi izohga qarang.
localestring (enum)Yo'qUZ, RU, ENStandart qiymat UZ.
additional_paramsobjectYo'qFaqat quyidagi kalitlarRS-ID SDK ekranlari sozlamalari. Boshqa har qanday kalit rad etiladi.
additional_params.langstringYo'quz, ru, enSDK ekranlari tili.
additional_params.themestringYo'qmasalan light, darkSDK ekranlari mavzusi.
additional_params.primary_colorstringYo'qHEX rang, masalan #1A73E8SDK ekranlarining asosiy rangi.
Chegara (threshold). threshold — identifikatsiyadan o'tish uchun selfi pasport fotosurati bilan taqqoslanganda olishi kerak bo'lgan minimal o'xshashlik bahosi (0.0 dan 1.0 gacha). Parametr yuborilmasa, standart qiymat 0.5 ishlatiladi. Agar o'zingiz yuborsangiz, 0.5 dan yuqori qiymat tavsiya etiladi. Yuqori aniqlikdagi (qat'iy) identifikatsiya uchun 0.7 dan yuqori qiymat yuboring. Qiymat qanchalik yuqori bo'lsa, tekshiruv shunchalik qat'iy va boshqa odamning o'tib ketish xavfi past bo'ladi, lekin haqiqiy foydalanuvchilarga ko'proq urinish kerak bo'lishi mumkin.
IP ga bog'lanish va yo'naltirish yo'q. Mobil sessiyalar ip_address va redirect_url dan foydalanmaydi. Natija SDK tomonidan ilovangizga qaytariladi (7.6).
So'rov namunalari — variantni tanlang:
user_info bilan sessiya

1-variant — user_info bilan sessiya#

Mijoz backendi foydalanuvchi ma'lumotlarini allaqachon biladi. SDK darhol kamerani ochadi.
{
  "client_type": "MOBILE",
  "external_id": "ORDER-123",
  "retry_count": 3,
  "threshold": 0.7,
  "locale": "UZ",
  "user_info": {
    "pinfl": "12345678901234",
    "birth_date": "01.01.1990"
  },
  "additional_params": {
    "lang": "uz"
  }
}
JSHSHIR o'rniga hujjat raqami bilan:
"user_info": { "id_number": "AA1234567", "birth_date": "01.01.1990" }
user_info siz sessiya
Qayta tekshirish (session_id)
Javob
MaydonTuriUzunlik / formatTavsif
datastringUUID, 36 belgiYangi sessiyaning session_id qiymati. Uni RS-ID SDK ga uzating va natijani olish uchun ishlating.
codeintegerMuvaffaqiyatda 0.
messagestringNatija matni.
{
  "data": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "code": 0,
  "message": "Success"
}
Xatolar
KodSabab
-1000Noto'g'ri so'rov — masalan, user_info da pinfl / id_number ikkalasi ham yuborilgan yoki hech biri yuborilmagan.
-1002Hisob ma'lumotlari Mobile SDK mijoziga tegishli emas yoki session_id boshqa mijozga tegishli.
-1024id_number formati noto'g'ri.
-1025pinfl formati noto'g'ri.
-1026birth_date yuborilmagan.
-1029session_id topilmadi.
-1034additional_params da noma'lum kalit.
-1052threshold 0–1 oralig'idan tashqarida.
-1090Foydalanuvchi 16 yoshga to'lmagan.
400Maydon validatsiyasi xatosi yoki client_type yuborilmagan.

7.4 RS-ID SDK ni ishga tushirish#

session_id bilan mijoz ilovasi RS-ID SDK ni ishga tushiradi.
1.
Backendingiz sessiya yaratadi (7.3) va session_id ni ilovaga qaytaradi.
2.
Ilova RS-ID SDK ni quyidagi parametrlar bilan ishga tushiradi:
ParametrTavsif
session_id7.3 dan.
access_tokenMobile SDK mijozingizning amal qilayotgan kirish tokeni. SDK undan RS-ID serveriga murojaat qilish uchun foydalanadi; server sessiya bo'yicha so'rovlarni faqat uni yaratgan mijoz tokeni bilan qabul qiladi.
MuhitStage yoki production — sessiya yaratilgan muhit bilan mos kelishi kerak.
Sessiyaning amal qilish muddati va urinishlar soni cheklangan. SDK ni sessiya yaratilgandan so'ng darhol ishga tushiring; muddati tugagan bo'lsa, yangisini yarating.

7.5 RS-ID SDK da foydalanuvchi harakatlari#

SDK ikki rejimga ega. Foydalanuvchi qaysi birini ko'rishi sessiya 7.3 da qanday yaratilganiga bog'liq:
SDK rejimiQachon ko'rsatiladiFoydalanuvchi nima qiladi
with_infoSessiya user_info siz va session_id siz yaratilgan (2-variant)Ma'lumotlarini kiritadi, so'ng selfi oladi
without_infoSessiya user_info bilan (1-variant) yoki oldingi session_id bilan (3-variant) yaratilganFaqat selfi oladi

with_info — ma'lumot kiritish, so'ng kamera#

SDK ma'lumot kiritish ekranidan boshlanadi.
1.
Foydalanuvchi pasport seriyasi va raqami yoki JSHSHIR hamda tug'ilgan sanasini (DD.MM.YYYY) kiritadi.
mobile-sdk-1-form_1.png
2.
Foydalanuvchi almashtirgich orqali Foydalanuvchi kelishuvi va Maxfiylik siyosatini qabul qiladi. Davom etish tugmasi faollashadi; foydalanuvchi uni bosadi.
mobile-sdk-2-form-filled_1.png
3.
Ilova kameraga ruxsat so'raydi (tizim oynasi). Foydalanuvchi ruxsat beradi.
4.
Kamera "Yuzingizni doira ichida tuting" ko'rsatmasi bilan ochiladi. Yuz topilmaguncha doira qizil bo'ladi; yuz to'g'ri joylashgach, selfi olinadi.
mobile-sdk-3-camera_1.png
5.
RS-ID "tiriklik"ni tekshiradi va yuzni kiritilgan shaxsning pasport fotosurati bilan taqqoslaydi. SDK "Identifikatsiya amalga oshirilmoqda" yozuvini ko'rsatadi.
mobile-sdk-4-processing_1.png
6.
Muvaffaqiyatli bo'lsa, SDK "Identifikatsiya qilish muvaffaqiyatli amalga oshirildi!" yozuvini ko'rsatadi va natijani ilovaga qaytaradi (7.6).
mobile-sdk-5-success_1.png

without_info — faqat kamera#

1.
Ilova kameraga ruxsat so'raydi (tizim oynasi). Foydalanuvchi ruxsat beradi.
2.
Kamera ochiladi. Foydalanuvchi yuzini doira ichiga joylashtiradi va selfi olinadi.
mobile-sdk-3-camera_1.png
3.
RS-ID "tiriklik"ni tekshiradi va yuzni pasport fotosurati bilan taqqoslaydi.
mobile-sdk-4-processing_1.png
4.
SDK natijani ilovaga qaytaradi (7.6).
mobile-sdk-5-success_1.png

Muvaffaqiyatsiz urinishlar#

Agar foydalanuvchi kameraga ruxsat bermasa, SDK davom eta olmaydi — foydalanuvchi telefon sozlamalarida ilovangiz uchun kameraga ruxsat berishi kerak.
Agar selfi rad etilsa (soxtalik aniqlandi, yuz mos kelmadi, fuqaro topilmadi), SDK sababni ko'rsatadi va urinishlar qolgan bo'lsa (retry_count), qayta urinish imkonini beradi. Urinishlar tugaganda yoki sessiya muddati o'tganda SDK muvaffaqiyatsizlik qaytaradi va mijoz yangi sessiya yaratishi kerak.

7.6 Ilovadagi natija#

Foydalanuvchi tekshiruvni yakunlagach, SDK natijani ilovangizga qaytaradi:
NatijaNima qilish kerak
MuvaffaqiyatBackendingizga sessiya yakunlanganini xabar qiling; backend profilni oladi (7.7).
MuvaffaqiyatsizlikUrinishlar tugagan yoki sessiya muddati o'tgan. Foydalanuvchi qayta urinmoqchi bo'lsa, yangi sessiya yarating (7.3).
Bekor qilindiFoydalanuvchi SDK ni yopdi. Sessiya faol ekan, SDK ni xuddi shu session_id bilan qayta ishga tushirish mumkin.
Ilovadagi natijaning o'zini identifikatsiya tasdig'i deb hisoblamang — ilova foydalanuvchi qurilmasida ishlaydi va o'zgartirilishi mumkin. Natijani har doim backendingizdan 7.7 orqali tasdiqlang.

7.7 Identifikatsiya natijasini olish#

Mijoz backendi tasdiqlangan fuqaro profilini oladi.
Metod - GET
Endpoint - {base_url}/v1/user/{session_id}
Authorization (sarlavha) - Bearer {access_token}

Yo'l parametrlari
MaydonTuriMajburiyUzunlik / formatTavsif
session_idstringHaUUID, 36 belgi7.3 dan.
Javob
MaydonTuriTavsif
data.session_idstringSessiya identifikatori.
data.comparison_valuenumberYuzlar o'xshashligi bahosi, 0–1.
data.notestringXato haqida izoh, agar bo'lsa.
data.profile.user_info.first_namestringIsm.
data.profile.user_info.last_namestringFamiliya.
data.profile.user_info.middle_namestringOtasining ismi.
data.profile.user_info.pinflstringJSHSHIR, 14 ta raqam.
data.profile.user_info.genderstringJinsi.
data.profile.user_info.birth_datestringyyyy-MM-dd.
data.profile.user_info.birth_placestringTug'ilgan joyi.
data.profile.user_info.birth_countrystringTug'ilgan mamlakati.
data.profile.user_info.nationalitystringMillati.
data.profile.user_info.citizenshipstringFuqaroligi.
data.profile.document_info.documentstringHujjat seriyasi va raqami.
data.profile.document_info.typestringHujjat turi.
data.profile.document_info.issued_bystringKim tomonidan berilgan.
data.profile.document_info.issued_atstringBerilgan sana, yyyy-MM-dd.
data.profile.document_info.expiry_atstringAmal qilish muddati, yyyy-MM-dd.
data.profile.permanent_addressobjectcountry, country_id, region_id, district_id, address.
data.profile.temporary_addressobjectnull bo'lishi mumkin.
{
  "data": {
    "session_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "comparison_value": 0.93,
    "profile": {
      "user_info": {
        "first_name": "ALISHER",
        "last_name": "KARIMOV",
        "middle_name": "BAXTIYOROVICH",
        "pinfl": "12345678901234",
        "gender": "MALE",
        "birth_date": "1990-01-01",
        "birth_place": "TOSHKENT",
        "birth_country": "UZBEKISTAN",
        "nationality": "UZBEK",
        "citizenship": "UZBEKISTAN"
      },
      "document_info": {
        "document": "AA1234567",
        "type": "PASSPORT",
        "issued_by": "IIV 26283",
        "issued_at": "2018-05-10",
        "expiry_at": "2028-05-09"
      },
      "contact_info": {},
      "permanent_address": {
        "country": "UZBEKISTAN",
        "country_id": 182,
        "region_id": 26,
        "district_id": 2603,
        "address": "..."
      },
      "temporary_address": null
    }
  },
  "code": 0,
  "message": "Success"
}
Xatolar
KodSabab
-1005Identifikatsiya muvaffaqiyatsiz.
-1027Sessiya muddati tugagan — natijani SDK muvaffaqiyat qaytargach darhol so'rang.
-1029Sessiya topilmadi.
-1002Sessiya boshqa mijozga tegishli.

8. Xato kodlari#

KodNomiMa'nosi
0SUCCESSMuvaffaqiyat.
-5BAD_CREDENTIALSHisob ma'lumotlari noto'g'ri yoki token foydalanuvchisi topilmadi.
-9SYSTEM_ERRORKutilmagan server xatosi.
-1000BAD_REQUESTNoto'g'ri so'rov.
-1002CLIENT_NOT_PERMITTEDBu mijoz uchun ruxsat yo'q.
-1005UNSUCCESS_JOBIdentifikatsiya muvaffaqiyatsiz.
-1008IDENTIFICATION_FAILEDYuz mos kelmadi.
-1024INVALID_ID_NUMBERHujjat raqami noto'g'ri.
-1025INVALID_PINFLJSHSHIR noto'g'ri.
-1026BIRTH_DATE_NOT_NULLTug'ilgan sana talab qilinadi.
-1027SESSION_EXPIREDSessiya muddati tugagan.
-1029JOB_SESSION_NOT_FOUNDSessiya topilmadi.
-1031RETRY_COUNT_EXPIREDUrinishlar tugadi.
-1032SUCCESS_JOB_EXISTS_FOR_SESSIONSessiya allaqachon muvaffaqiyatli o'tilgan.
-1033SPOOFED_FILE_DETECTED"Tiriklik" tekshiruvidan o'tilmadi.
-1034ADDITIONAL_PARAMS_INVALIDadditional_params da noma'lum kalit.
-1052INVALID_THRESHOLD_LIMITthreshold 0–1 oralig'idan tashqarida.
-1090USER_AGE_OLDER_THAN_16Foydalanuvchi kamida 16 yoshda bo'lishi kerak.
-2001AI_ERRORYuzni aniqlash servisida xato.

Modified at 2026-11-10 09:19:15
Previous
Foydalanuvchi ma'lumotlarini olish
Next
Avtorizatsiya (sign-in)
Built with