A3.Trust ni ochish

Mahsulotlar va integratsiyalar uchun API

A3.Trust xulosalarni boshqa tizimlarga yetkazib beradi: A3.HR, A3.Sales, kompaniyaning kadr va xarid tizimlariga. Ochiq API va vebhuklar birinchi relizdan ishlaydi, mahsulotdagi qumloq esa kod oʻqimasdan ulanishga yordam beradi.

Tamoyillar

  • Kirish ruxsatlari bilan API kaliti

    Kalit integratsiyalar boʻlimida huquqlar toʻplami bilan chiqariladi: tekshiruv yaratish, tekshiruvlarni oʻqish, monitoring, subyektlarni oʻqish, buyurtmalarni tekshirish. Kalitni toʻxtalishsiz qayta chiqarish mumkin.

  • Idempotentlik

    Soʻrovni oʻsha Idempotency-Key bilan qayta yuborish ikkinchi tekshiruvni yaratmaydi va uni paketdan hisobdan chiqarmaydi. Oʻsha kalit boshqa tana bilan xato qaytaradi.

  • Chastota cheklovi

    Daqiqadagi soʻrovlar limiti har bir kalit uchun belgilanadi. Oshib ketganda tushunarli xato qaytadi, soʻrovlar jurnali esa har bir chaqiruvni koʻrsatadi.

  • Materiallar emas, xulosa

    API qarorni buyurtmachi hajmida beradi: turi, cheklovlar, muddat. Subyekt faqat identifikator boʻyicha qidiriladi, dosyelarni familiya boʻyicha saralab chiqib boʻlmaydi.

Asosiy amallar

Metodlar tashkilotingizning saqlash hududidagi PublicApi manzilida mavjud. Maydonlarning toʻliq roʻyxati API hujjatlarida.

POSTCreateCheckRequest

Tekshiruv soʻrovini yaratish

GETGetCheckRequestStatus

Soʻrov holati va xulosa

GETGetActiveVerdict

Yangi tekshiruvsiz amaldagi xulosa

POSTSetSubjectMonitoring

Subyektni monitoringga qoʻyish

DELETERemoveSubjectMonitoring

Subyektni monitoringdan olish

GETGetSubjectRiskLabels

Subyektning risk belgilari

GETFindSubject

Subyektni identifikator boʻyicha qidirish

POSTCheckOrderCompliance

Buyurtmani taqiqlangan xizmatlar reyestri boʻyicha tekshirish

Misol: subyekt boʻyicha amaldagi xulosa

Isteʼmolchi tizimlar uchun asosiy ssenariy: yangi tekshiruv yaratmasdan qarorni olish.

GET /PublicApi/GetActiveVerdict?subjectId=1024
API-KEY: a3t_7c41…
Domain: company
{
  "verdictType": "ApprovedWithRestrictions",
  "riskLevel": "Moderate",
  "restrictions": [
    { "type": "FullPrepayment" },
    { "type": "AmountLimit", "amount": 25000000, "currency": "KZT" }
  ],
  "validUntil": "2027-10-14",
  "reasonForRequester": "Налоговая задолженность погашена, судебные споры в работе"
}

Vebhuklar

Isteʼmolchi tizimlar API ni siklda soʻrab turmaydi: hodisalar oʻzi keladi. Har bir chaqiruv HMAC-SHA256 bilan imzolanadi, yetkazish jurnali qabul qiluvchi javobini koʻrsatadi, muvaffaqiyatsiz yetkazishni takrorlash mumkin.

trust.check.accepted

Soʻrov ishga qabul qilindi

trust.check.rejected

Soʻrov sabab koʻrsatilib rad etildi

trust.check.info_requested

Qoʻshimcha maʼlumotlar soʻraldi

trust.check.completed

Xulosa shakllantirildi

trust.check.verdict_revoked

Xulosa bekor qilindi yoki qayta koʻrildi

trust.monitoring.alert

Monitoringning kritik ogohlantirishi

Mahsulotdagi qumloq

Integratsiyalar boʻlimida administrator kalit va amalni tanlaydi, tayyor soʻrov namunasini tahrirlaydi hamda javob va curl buyrugʻini koʻradi. Maʼlumotlarni oʻzgartiradigan amallar alohida tasdiqlashni talab qiladi.

A3.HR bilan kontrakt

Nomzodlarni tekshirish qutidan tashqari ishlaydi: hr.background_check va trust.check hodisalari mahsulotlarning API kontraktlari darajasida kelishilgan.

API hujjatlariMateriallar va yoʻriqnomalar