A3.Trust ачуу

Продуктулар жана интеграциялар үчүн API

A3.Trust чечимдерди башка системаларга берет: A3.HR, A3.Sales, компаниянын кадр жана сатып алуу системаларына. Ачык API жана вебхуктар биринчи релизден тартып иштейт, ал эми продукттагы сыноо чөйрөсү код окубай эле туташууга жардам берет.

Принциптер

  • Уруксаттары бар API ачкычы

    Ачкыч интеграциялар бөлүмүндө уруксаттар топтому менен чыгарылат: текшерүүлөрдү түзүү, текшерүүлөрдү окуу, мониторинг, субъекттерди окуу, буйрутмаларды текшерүү. Ачкычты иш токтобой туруп кайра чыгарса болот.

  • Идемпотенттүүлүк

    Ошол эле Idempotency-Key менен сурамды кайра жөнөтүү экинчи текшерүүнү түзбөйт жана аны пакеттен эсептен чыгарбайт. Ошол эле ачкыч башка мазмун менен катаны кайтарат.

  • Жыштыкты чектөө

    Мүнөтүнө сурамдардын лимити ар бир ачкычка белгиленет. Лимиттен ашуу түшүнүктүү катаны кайтарат, ал эми сурамдар журналы ар бир чакырууну көрсөтөт.

  • Материалдар эмес, чечим

    API чечимди буюртмачыга жеткиликтүү көлөмдө берет: түрү, чектөөлөр, мөөнөтү. Субъект идентификатор боюнча гана изделет, досьелерди фамилия боюнча иргеп чыгууга болбойт.

Негизги операциялар

Методдор уюмуңуздун сактоо аймагындагы PublicApi дареги боюнча жеткиликтүү. Талаалардын толук тизмеси API документациясында.

POSTCreateCheckRequest

Текшерүү сурамын түзүү

GETGetCheckRequestStatus

Сурамдын статусу жана чечим

GETGetActiveVerdict

Жаңы текшерүүсүз жарактуу чечим

POSTSetSubjectMonitoring

Субъектти мониторингге коюу

DELETERemoveSubjectMonitoring

Субъектти мониторингден алуу

GETGetSubjectRiskLabels

Субъекттин тобокелдик белгилери

GETFindSubject

Субъектти идентификатор боюнча издөө

POSTCheckOrderCompliance

Буйрутманы тыюу салынган кызматтар реестри боюнча текшерүү

Мисал: субъект боюнча жарактуу чечим

Керектөөчү системалар үчүн негизги сценарий: жаңы текшерүү түзбөй эле чечимди алуу.

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": "Налоговая задолженность погашена, судебные споры в работе"
}

Вебхуктар

Керектөөчү системалар API менен циклде сурамжылабайт: окуялар өзү келет. Ар бир чакыруу HMAC-SHA256 кол тамгасы менен корголгон, жеткирүү журналы алуучунун жообун көрсөтөт, ийгиликсиз жеткирүүнү кайталоого болот.

trust.check.accepted

Сурам иштетүүгө кабыл алынды

trust.check.rejected

Сурам себеби менен четке кагылды

trust.check.info_requested

Кошумча маалымат сурамы жөнөтүлдү

trust.check.completed

Чечим түзүлдү

trust.check.verdict_revoked

Чечим кайтарылып алынды же кайра каралды

trust.monitoring.alert

Критикалык мониторинг дабылы

Продукттагы сыноо чөйрөсү

Интеграциялар бөлүмүндө администратор ачкычты жана операцияны тандап, даяр сурам мисалын оңдойт, жоопту жана curl буйругун көрөт. Маалыматтарды өзгөрткөн операциялар өзүнчө ырастоону талап кылат.

A3.HR менен контракт

Талапкерлерди текшерүү кошумча жөндөөсүз иштейт: hr.background_check жана trust.check окуялары продуктулардын API-контракттары деңгээлинде макулдашылган.

API документациясыМатериалдар жана нускамалар