Role

INFO

Har bir javob umumiy konvertda qaytadi — code, message, messages, status_code, time — foydali yuk esa data ichida. Quyidagi jadvallar faqat data ichini tavsiflaydi.

POST /role/create

Create a role with its permission access map.

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
name	string	Ha	Role name
access	object	Ha	permission map: key → access degree (a|s|r|d)
web_access	object	Yo‘q	permission map for the web back-office surface
mobile_access	object	Yo‘q	permission map for the mobile/POS surface

{
  "name": "string",
  "access": {},
  "web_access": {},
  "mobile_access": {}
}

Javob

Maydon	Tur	Tavsif
_id	string
name	string
web	boolean
mobile	boolean

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "_id": "string",
    "name": "string",
    "web": false,
    "mobile": false
  },
  "time": "2025-05-01T12:00:00Z"
}

PUT /role/update

Update an existing role and its permission access map.

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
name	string	Ha	Role name
access	object	Ha	permission map: key → access degree (a|s|r|d)
web_access	object	Yo‘q	permission map for the web back-office surface
mobile_access	object	Yo‘q	permission map for the mobile/POS surface
_id	string	Ha

{
  "name": "string",
  "access": {},
  "web_access": {},
  "mobile_access": {},
  "_id": "string"
}

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /role/create.

DELETE /role/delete/{id}

Delete a role

Yo‘l parametrlari

Parametr	Tur	Majburiy	Tavsif
id	string	Ha

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": "ok",
  "time": "2025-05-01T12:00:00Z"
}

GET /role/get-by-id/{id}

Get role using its _id

Yo‘l parametrlari

Parametr	Tur	Majburiy	Tavsif
id	string	Ha

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /role/create.

POST /role/get-paging

Get roles by paging

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
page	number	Ha	Standart: 1
limit	number	Ha	Standart: 20
search	string	Yo‘q
nin	string[]	Yo‘q

{
  "page": 1,
  "limit": 20,
  "search": "string",
  "nin": [
    "63f8b0c4e4b0d3a2f8e4b0c4"
  ]
}

Javob

data.total — jami yozuvlar soni, data.data[] — joriy sahifadagi yozuvlar. Quyidagi jadval bitta yozuvni tavsiflaydi.

Maydon	Tur	Tavsif
_id	string
name	string
web	boolean
mobile	boolean

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "total": 0,
    "data": [
      {
        "_id": "string",
        "name": "string",
        "web": false,
        "mobile": false
      }
    ]
  },
  "time": "2025-05-01T12:00:00Z"
}

---

Bu sahifa OpenAPI spetsifikatsiyasidan yaratilgan.