Asosiy qismga oʻtish
API hujjati API kalitini olish

Boshlash · 3-bob

Sinov va ishchi rejim

Butun integratsiyani sinov rejimida soxta natijalar bilan quring va sinang, biznesingiz tasdiqlangach esa ishchi kalitga oʻting.

3 daqiqa oʻqish

Sinov va ishchi rejim farqi

Sinov Ishchi
API kalit prefiksi sk_test_ sk_live_
Tekshiruvlar Haqiqiy tekshiruv yoʻq. Natija external_id qoʻshimchasi bilan tanlanadi Hujjat maʼlumotlarini oʻqish, hujjat haqiqiyligini tekshirish, shaxs ishtirokini tekshirish, selfi va hujjat mosligi hamda ixtiyoriy AML
Rasmlar Istalgan rasm qabul qilinadi Haqiqiy hujjat va haqiqiy odam kerak
Hujjat maʼlumotlari Sintetik namuna, ombordan hech narsa oʻqilmaydi Odamning hujjat maʼlumotlari
Webhooklar Ishchi rejimdagidek yuboriladi, "env": "sandbox" bilan "env": "live"
Oylik limit Cheklanmagan, lekin GET /usage → sandbox da hisoblanadi Tarifingiz limiti
Qachon ochiladi Roʻyxatdan oʻtgan zahoti Biznes tasdiqlangandan keyin

Ikkalasi uchun asosiy URL bir xil: https://kyc.goxost.net/api/v1. Muhitni kalit belgilaydi va har bir kalit faqat oʻz muhitini koʻradi. Sinov rejimidagi arizachilar, sessiyalar, webhook endpointlari va tekshiruvlar ishchi rejimdan alohida; bir muhitdagi ID ikkinchisida 404 not_found qaytaradi.

Panelda bu rejimlar Sinov va Ishchi deb ataladi.

Sinov rejimida natijani tanlash

sk_test_ kalit bilan qaror arizachining external_id si qanday tugashiga bogʻliq. Qoʻshimcha sessiya yaratilganda oʻqiladi.

external_id oxiri Qaror decision_type reject_labels
boshqa har qanday (masalan, -green) GREEN null []
-expired RED retry DOC_EXPIRED
-mismatch RED final FACE_MISMATCH
-hold ON_HOLD null PEP_MATCH
-sanctions RED final SANCTIONS_MATCH
-duplicate RED final DUPLICATE
-underage RED final UNDERAGE
-age-unknown ON_HOLD null AGE_UNKNOWN
-recapture ON_HOLD null DOC_SCREEN_RECAPTURE
{ "external_id": "user-8812-hold" }

Izohlar:

  • -age-unknown faqat «faqat yosh» senariysida ishlaydi (paneldagi Sozlamalar → Tekshiruvlar); boshqa senariylarda u GREEN beradi. «Faqat yosh» senariysida har bir natijada age tekshiruvi ham boʻladi, -sanctions va -duplicate esa GREEN beradi, chunki u yerda AML va takror tekshiruvlari ishlamaydi.
  • -duplicate sinov rejimida boshqa arizachilarning ID larini qaytarmaydi.
  • -recapture hujjat haqiqiyligi tekshiruvidan oʻtmagan holatni koʻrsatadi: warn holatidagi doc_fraud tekshiruvini qoʻshadi; boshqa sinov natijalarida bunday tekshiruv yoʻq.

Sinov rejimidagi hujjat maʼlumotlari

Sinov rejimida GET /verifications/{id} document.data ichida sintetik namunaviy hujjatni qaytaradi: «ERIKSSON ANNA MARIA», pasport L898902C3, davlat UTO. Sanalar tekshiruv vaqtiga nisbatan hisoblanadi. -expired da hujjat muddati oʻtgan (is_expired: true); -underage da yosh 16. «Faqat yosh» senariylarida document.data ishchi rejimdagidek null boʻladi.

Kodingizning har bir tarmogʻini sinov rejimida sinang: GREEN, retry bilan RED, final bilan RED va ON_HOLD hamda undan keyingi koʻrib chiqish. Sinov rejimidagi ON_HOLD ni POST /verifications/{id}/review orqali yoki panelda hal qilib, verification.reviewed ni qabul qilishingiz mumkin.

Maslahat

Sinov rejimida Direct API

sk_test_ kalit bilan Direct API haqiqiy tekshiruv oʻtkazmaydi: har bir tekshiruv 0.99 ball bilan soxta pass qaytaradi, hujjat tekshiruvi esa oʻsha sintetik namunani qaytaradi. Chaqiruvlar cheklanmaydi, lekin hisoblanadi.

Ishchi rejimga oʻtish

Sinov rejimi roʻyxatdan oʻtgan zahoti ochiladi. Ishchi rejim — sk_live_ kalit yaratish, ishchi API va paneldagi ishchi muhit — paneldagi ikki qadamdan keyin ochiladi:

  1. Biznes profili. Biznes turi (company, entrepreneur yoki individual), yuridik nom, roʻyxatdan oʻtish raqami (jismoniy shaxslar uchun ixtiyoriy), davlat, sayt, loyiha nomi va tavsifi, foydalanish maqsadi va tekshiruvning sukut boʻyicha maqsadi. Dalolatnomalar va ochiq tekshirish sahifasi tekshiruvni qaysi biznes va loyiha nima maqsadda oʻtkazganini shu profildan koʻrsatadi.
  2. Egasining shaxsi. Hisob egasi oddiy KYC tekshiruvidan oʻtadi. GREEN hisobni tasdiqlaydi; ON_HOLD ni GOXOST xodimlari koʻrib chiqadi; RED dan keyin qayta urinish mumkin (jami 3 ta urinish).

Ikkala qadam tugamaguncha sk_live_ kalitli har qanday soʻrov quyidagini qaytaradi:

{
  "error": {
    "code": "tenant_not_verified",
    "message": "Live mode opens after your business profile and owner identity are verified.",
    "request_id": "req_01m6yyj5gq0x3c7d2n8v5kp4rt"
  }
}

HTTP holati 403 bilan. Keyinchalik yuridik nom, roʻyxatdan oʻtish raqami yoki biznes turini oʻzgartirsangiz, ishchi rejim ishlashda davom etadi, lekin profil qayta koʻrib chiqishga belgilanadi.

Limitlar va bepul tarif

Bepul tarif oyiga 100 ta ishchi tekshiruv ni oʻz ichiga oladi. Birlik sessiya yaratilganda band qilinadi va sessiya ishlatilmay muddati oʻtsa, yangi sessiya bilan almashtirilsa yoki arizachi topshirishdan oldin qayta tiklansa yoxud oʻchirilsa, qaytariladi. Alohida AML tekshiruvi va Direct API chaqiruvlarining shu limitdagi oʻz oylik hisoblagichlari bor. Ishchi rejim limiti tugaganda API 429 plan_limit_reached qaytaradi.

Hisoblagichlarni GET /usage bilan tekshiring:

{
  "period": "2026-11",
  "plan": "free",
  "limit": 100,
  "live": { "verifications": 12, "aml_checks": 0, "direct_checks": 0 },
  "sandbox": { "verifications": 51, "aml_checks": 0, "direct_checks": 7 },
  "core_url": "https://…/v1"
}

core_url — Direct API chaqiruvlari uchun asosiy URL.