Dasturchilar uchun

API va xavfsiz xatolar

Tashqi ilovaning asosiy endpoint’lari va kontekst tekshiruvi muvaffaqiyatsiz bo‘lgandagi xatti-harakat.

Yangilangan: 2026-yil 10-avgust

Ochiq Web Chat API

httpKanyman docs

POST /api/public/web-chat/{public_key}/sessions
Idempotency-Key: <unique-session-creation-key>
Content-Type: application/json

{
  "locale": "uz",
  "context_token": "<optional-signed-jwt>"
}

httpKanyman docs

PUT /api/public/web-chat/{public_key}/sessions/{session_id}/context
Authorization: Bearer <session_token>
Content-Type: application/json

{ "context_token": "<signed-jwt>" }

Kontekstni qayta ishlash natijasi

jsonKanyman docs

{
  "context_status": "rejected",
  "context_id": null,
  "context_error_code": "context_expired"
}

Kontekst xatosi chat sessiyasini bekor qilmaydi. Interfeys oddiy chatni davom ettirishi va texnik ma’lumot vaqtincha mavjud emasligi haqida neytral xabar ko‘rsatishi kerak.

Kabinet API’si

textKanyman docs

GET  /api/projects/{project_id}/external-integrations
POST /api/projects/{project_id}/external-integrations
GET  /api/projects/{project_id}/external-integrations/{integration_id}
POST /api/projects/{project_id}/external-integrations/{integration_id}/test-token
GET  /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools/{tool_id}/test
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools/{tool_id}/hmac-credentials
GET  /api/projects/{project_id}/external-integrations/{integration_id}/connector-catalog
GET  /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/manifest
POST /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/provision-plan
POST /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/provision
GET  /api/projects/{project_id}/external-integrations/{integration_id}/actions
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions
GET  /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/confirm
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/cancel
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/reconcile

GET  /api/projects/{project_id}/solution-packs/catalog
GET  /api/projects/{project_id}/solution-packs
POST /api/projects/{project_id}/solution-packs/install
POST /api/projects/{project_id}/solution-packs/{installation_id}/refresh
POST /api/projects/{project_id}/solution-packs/{installation_id}/activate
POST /api/projects/{project_id}/solution-packs/{installation_id}/disable
POST /api/projects/{project_id}/solution-packs/{installation_id}/rollback
GET  /api/projects/{project_id}/solution-packs/{installation_id}/scenarios
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/{scenario_key}/preview
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/{scenario_key}/drafts
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/submit
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/activate
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/archive

POST /api/public/web-chat/{public_key}/sessions/{session_id}/actions/{action_id}/confirm
POST /api/public/web-chat/{public_key}/sessions/{session_id}/actions/{action_id}/cancel

Konfiguratsiyani yaratish va sinash tanlangan loyihada owner yoki admin rolini talab qiladi. Barcha amallar workspace/project scope’ni tekshiradi.

Jurnallar va xatolar

Davom etish

Imzolangan kontekstJWT-konvert, JSON Schema, imzo va takroriy so‘rovdan himoya.Tasdiqlanadigan amallarAmal hayot sikli, Idempotency-Key va noma’lum natijani qayta ishlash.Xavfsizlik va ishga tushirishKalitlar, tokenlar, tarmoq cheklovlari va production UAT ro‘yxati.