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-ийн баримт бичигМатериал, заавар