Portal / RFID reader

Mô tả

Cấu hình cổng / reader RFID. Các API hỗ trợ:

• GET /portals: Danh sách
• GET /{id}: Chi tiết
• POST /portals: Tạo
• PUT /{id}: Cập nhật
• GET /product: Sản phẩm crossover

API

---

GET /api/portals

Danh sách portal:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
created_from	string	yyyy-MM-dd'T'HH:mm:ss	Không
created_to	string	yyyy-MM-dd'T'HH:mm:ss	Không
page	integer	Trang	Không
size	integer	Số bản ghi trên trang	Không
sort	string	Tên trường sắp xếp	Không
order	string	asc / desc	Không

GET /api/portals?page=1&size=20

result là mảng portal: id, name, ip, hostName, username, readWorkingHours, created_at, created_by, updated_at, updated_by.

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [
    {
      "id": "{uuid}",
      "name": "Cổng 1",
      "ip": "192.168.1.50",
      "hostName": "reader-1",
      "readWorkingHours": true
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1
}

---

GET /api/portals/{id}

Chi tiết portal / reader.

GET /api/portals/\{id\}

Response Body

{
  "code": 200,
  "message": "Success",
  "result": {}
}

---

POST /api/portals

Tạo portal.

Request Body

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
name	string	Tên portal	Không
ip	string	IP reader	Không
hostName	string	Hostname	Không
username	string	User đăng nhập reader	Không
password	string	Password reader	Không
readWorkingHours	boolean	Chỉ đọc trong giờ làm việc	Không

POST /api/portals

Request Body

{
  "name": "Cổng 1",
  "ip": "192.168.1.50",
  "hostName": "reader-1",
  "username": "admin",
  "password": "********",
  "readWorkingHours": true
}

Response Body

{
  "code": 200,
  "message": "Success",
  "result": true
}

---

PUT /api/portals/{id}

Cập nhật portal (cùng schema create).

Request Body

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
name	string	Tên portal	Không
ip	string	IP reader	Không
hostName	string	Hostname	Không
username	string	User	Không
password	string	Password	Không
readWorkingHours	boolean	Chỉ đọc trong giờ LV	Không

PUT /api/portals/\{id\}

Request Body

{
  "name": "Cổng 1",
  "ip": "192.168.1.50"
}

Response Body

{
  "code": 200,
  "message": "Success",
  "result": true
}

---

GET /api/portals/product

Sản phẩm / sự kiện crossover theo portal:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
page	integer	Trang	Không
size	integer	Số bản ghi trên trang	Không
sort	string	Tên trường sắp xếp	Không
order	string	asc / desc	Không

GET /api/portals/product?page=1&size=20

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [],
  "page": 1,
  "page_size": 20,
  "total": 0
}