Dasturchilar uchun

Tasdiqlanadigan amallar

Modelga to‘g‘ridan-to‘g‘ri write kirishi bermasdan tashqi mahsulot ma’lumotlarini o‘zgartirish uchun fail-closed kontrakt.

Yangilangan: 2026-yil 10-avgust

Draft capability

jsonKanyman docs

{
  "name": "prepare_delivery_retry",
  "capability_version": "1.0.0",
  "side_effect": "draft",
  "confirmation_policy": "required",
  "idempotency_policy": "required",
  "method": "POST",
  "url": "https://api.example.com/kenyman/actions/delivery-retry"
}

Hayot sikli

textKanyman docs

awaiting_confirmation
  → confirmed
  → executing
  → succeeded | failed | unknown_result

awaiting_confirmation | confirmed
  → cancelled

awaiting_confirmation
  → expired

Mahsulot endpoint’i server-side confirmation’dan oldin chaqirilmaydi. Amalni loyiha owner/admin’i kabinetda yoki yakuniy foydalanuvchi o‘zining avtorizatsiyalangan Web Chat sessiyasida tasdiqlashi mumkin. Tasdiqdan keyin amal durable navbatga tushadi va alohida worker tomonidan bajariladi.

Endpoint’ingizga so‘rov

httpKanyman docs

POST /kanyman/actions/delivery-retry
Idempotency-Key: action_...
Authorization: Bearer ...
X-Kanyman-Key-Id: connector-current
X-Kanyman-Timestamp: ...
X-Kanyman-Nonce: ...
X-Kanyman-Body-SHA256: ...
X-Kanyman-Signature: ...

{
  "request_id": "ktc_action_...",
  "integration_id": "ext_...",
  "action_id": "action_...",
  "capability_version": "1.0.0",
  "subject": "opaque-user-reference",
  "entities": [{ "type": "project", "ref": "prj_..." }],
  "input": { "request_id": "req_..." }
}

Idempotency-Key’ni amalning yagona kaliti sifatida qayta ishlang va takroriy so‘rovda ayni natijani qaytaring.
Brauzerdan kelgan subject, integration_id, action_id va capability_version qiymatlariga ishonmang.
Qo‘lda reconciliation qilish uchun action_id bilan ichki amal orasidagi bog‘lanishni saqlang.

Noma’lum natija

Davom etish

Read-only vositalarDolzarb diagnostika uchun xavfsiz HTTP-chaqiruvlar.API va xatolarWeb Chat ommaviy endpointlari va xavfsiz xato kodlari.Xavfsizlik va ishga tushirishKalitlar, tokenlar, tarmoq cheklovlari va production UAT ro‘yxati.