API texnik tafsilot emas, mahsulot funksiyasi

Ochiq REST rad etilgan umumiy vazifa dvigatelini almashtiradi. Unga ulanish qanchalik arzon boʻlsa, mahsulotlar orqali oʻtuvchi umumiy ish roʻyxati shunchalik real boʻladi.

Shartnomaga nima qoʻyilgan

Yoʻl boʻyicha versiyalash

Barcha kontroller /api/v1 ostida joylashgan. Buzuvchi oʻzgarish oʻtish davrida oldingi versiya qoʻllab-quvvatlanishini talab qiladi, eski yoʻllar ikki reliz davomida alias boʻlib qoladi.

Yozuvning idempotentligi

Yozuv amallari idempotentlik kalitini qabul qiladi. Tarmoq uzilgandagi takroriy chaqiruv ikkinchisini yaratmay, yozuvni yangilaydi. Bunday integratsiyalardagi eng koʻp uchraydigan xato shu.

Huquqlar interfeysdagidek

A3.ID orqali autentifikatsiya, kirish tekshiruvlari interfeysdagidek. Tashqi ishtirokchiga iqtisodiy maydonlar mijozda yashirilmaydi, umuman berilmaydi.

Ekotizim uchun alohida limit

Integratsiya trafigi tabiatan choʻqqili, mijoz trafigi esa bir tekis. Ikkalasiga bitta limit qoʻyish yo integratsiyalarni boʻgʻardi, yo suiisteʼmoldan himoya qilmasdi.

Metod guruhlari

GET/api/v1/tasksSahifalash, filtrlar va saralashli vazifalar roʻyxati
POST/api/v1/tasksVazifa yaratish, status almashtirish, tayinlash, guruh amallari
POST/api/v1/assignmentsIdempotentlik kaliti bor tashqi topshiriq
PUT/api/v1/assignments/{key}Tashqi kalit boʻyicha yangilash va yopish
GET/api/v1/projectsLoyihalar, ishtirokchilar, nuqtalar va byudjet
POST/api/v1/time-entriesVaqt yozish, oʻqish va tasdiqlash
GET/api/v1/views/overdueTayyor kesimlar: mening vazifalarim, muddati oʻtganlar, loyiha boʻyicha
POST/api/v1/exportChaqiruvchining huquqi bilan tashkilot maʼlumotini chiqarish

Tashqi topshiriq

Mahsulot manba oʻz obyektini va unga havolani uzatadi. Xuddi shu externalKey bilan takroriy chaqiruv ikkinchisini yaratmay, vazifani yangilaydi.

POST /api/v1/assignments

{
  "externalKey": "legal-case-8421",
  "sourceProduct": "lawyer",
  "sourceEntityType": "LegalCase",
  "sourceEntityId": "8421",
  "deepLink": "https://app.lawyer.a3.solutions/cases/8421",
  "title": "Подготовить исковое заявление",
  "assigneeId": "u-2f9c",
  "dueDate": "2026-10-02"
}

Vebhuklar

Mahsulot manba A3.Projectsʼni jadval boʻyicha soʻramasligi uchun hodisalarga obuna.

task.createdVazifa interfeysda yoki API orqali yaratildi

task.status_changedVazifa holatini almashtirdi, qayta ishlashga qaytarishni ham qoʻshib

task.closedVazifa yakunlandi yoki sababi koʻrsatilib bekor qilindi

time_entry.loggedVaqt yozildi, joylashtirilgan vidjet orqali ham

project.status_changedLoyiha toʻxtatildi, yakunlandi yoki bekor qilindi

budget.threshold_reachedByudjet chegarasiga yetildi, har chegaraga bir marta ishlaydi

Shaxsiy kirish tokenlari

Token aniq integratsiya uchun yaratiladi va egasining huquqidan keng boʻlmagan aniq roʻyxat bilan cheklanadi. Bazada faqat xesh saqlanadi, amal muddati 180 kundan oshmaydi.

Sohalar toʻliq emas, aniq roʻyxat bilan cheklangan
Bazada faqat SHA-256, tokenni qayta koʻrsatib boʻlmaydi
Amal muddati 180 kundan oshmaydi, uzaytirish yangi token talab qiladi
Tokenlar tokenning oʻzi bilan emas, sessiya orqali boshqariladi

SIʼ agentiga kirish

Oʻsha ochiq API ekotizim agentiga MCP orqali kirish nuqtasi boʻladi. Agent foydalanuvchi nomidan va oʻsha kirish tekshiruvlari bilan ishlaydi.

Huquq boʻyicha rad etish boʻsh roʻyxat emas, asbob xatosi boʻlib qaytadi. Aks holda agent vazifalar shunchaki koʻrinmaydigan joyda «sizda vazifa yoʻq» derdi.

Shartnoma ochiq

Sxema, soʻrov misollari va xato kodlari eʼlon qilingan. Qumloq birinchi etalon integratsiyadan keyin paydo boʻladi: birinchi isteʼmolchisiz u oʻylab topilgan stsenariyga xizmat qilardi.

Ulanish Integratsiyalar