---
# System prepended metadata

title: Nhagoc API CLIENT

---

---
title: Nhagoc API CLIENT
---




### khách hàng
- buytype khác formality
#### Tạo khách hàng
**api**: localhost:9000/admin/api/v4/clients
**method**: post
**body**: 
```
{
        "hostInfo": {
            "name": "Nguyễn Tiến Doanh",
            "phone1": "0384989499",
            "phone2": ""
        },
        "status": "active",
        "title": "Title sản phẩm324234234---- 2234233424 ----23423424234",
        "description": "Content sản phẩm",
        "province": "Hồ Chí Minh",
        "provinceId": 2,
        "district": "Quận Tân Bình",
        "districtId": 2,
        "ward": "Phường 13",
        "wardId": 2,
        "street": "Võ Thành Trang",
        "streetId": 2,
        "formality": "cho-thue",
        "type": "nha-mat-tien",
        "width": 10,
        "length": 20,
        "acreage": 200,
        "floorNumber": 2,
        "badger": true,
        "elevator": true,
        "basement": true,
        "expandStyle": "no-hau",
        "expandStyleInfo": 2,
        "price": "1",
        "currency": "tỷ",
        "priceDisplay": "1 tỷ",
        "typeOfPayment": "month",
        "hasCorner": true,
        "cornerNumber": 2,
        "showInWeb": false,
        "commission": false,
        "list_image": [],
        "field": 12 // Linh vuc
        "buyType": 'kinh-doanh' // Muc dich mua ['Kinh doanh', 'Cho thuê', 'Nhà ở' ]
    }
```
    
#### Sửa khách hàng
**api**: localhost:9000/admin/api/v4/clients/1
**method**: PUT
**body**: 
```
{
        "hostInfo": {
            "name": "Nguyễn Tiến Doanh",
            "phone1": "0384989499",
            "phone2": ""
        },
        "status": "active",
        "title": "Title sản phẩm324234234---- 2234233424 ----23423424234",
        "description": "Content sản phẩm",
        "province": "Hồ Chí Minh",
        "provinceId": 2,
        "district": "Quận Tân Bình",
        "districtId": 2,
        "ward": "Phường 13",
        "wardId": 2,
        "street": "Võ Thành Trang",
        "streetId": 2,
        "formality": "cho-thue",
        "type": "nha-mat-tien",
        "width": 10,
        "length": 20,
        "acreage": 200,
        "floorNumber": 2,
        "badger": true,
        "elevator": true,
        "basement": true,
        "expandStyle": "no-hau",
        "expandStyleInfo": 2,
        "price": "1",
        "currency": "tỷ",
        "priceDisplay": "1 tỷ",
        "typeOfPayment": "month",
        "hasCorner": true,
        "cornerNumber": 2,
        "showInWeb": false,
        "commission": false,
        "list_image": [],
        "field": 12 // Linh vuc
        "buyType": 'kinh-doanh' // Muc dich mua ['Kinh doanh', 'Cho thuê', 'Nhà ở' ]
    }
```
    
#### Tìm kiếm khách hàng

**api**: localhost:9000/admin/api/v4/clients?provinceId&districtId&wardId&streetId&width&length&acreage&hasCorner=&price&phone=0384989499&typeOfPayment&id=2&field=3
**method**: get
**param**:

```
provinceId	
districtId	
wardId	
streetId	
width	
length	
acreage	
hasCorner	
price	
phone // admin mới có quyền search
typeOfPayment	
id
field //Lĩnh vực (id của attribute lĩnh vực) 
```

#### Làm mới khách hàng

**api**: localhost:9000/admin/api/v4/clients/1/refresh
**method**: get


#### Check trùng khách hàng

**api**: localhost:9000/admin/api/v4/checkClient
**method**: post
**body**: 
```
{
        "hostInfo": {
            "name": "Nguyễn Tiến Doanh",
            "phone1": "0384989499",
            "phone2": ""
        },
        "field": 1,
}
```

### Form - Biểu mẫu

#### Danh sách - filter theo tên

**api**: localhost:9000/admin/api/v4/forms?q=timkiem
**method**: get
**param**: q


#### Thêm biểu mẫu

**api**: localhost:9000/admin/api/v4/forms
**method**: post
**body**: 
```
{
    "title": ,
    "description": ,
    "file"
}
```

Xem postman [https://prnt.sc/oyhxwz](https://prnt.sc/oyhxwz)

#### chỉnh sửa biểu mẫu

**api**: localhost:9000/admin/api/v4/forms/{id}
**method**: post
**body**: 
```
{
    "title": ,
    "newFile": true, // nếu thay đổi file
    "description": ,
    "file"
}
```

Xem postman [https://prnt.sc/oyi44q](https://prnt.sc/oyi44q)
#### chi tiết biểu mẫu

**api**: localhost:9000/admin/api/v4/forms/{id}
**method**: get


#### xóa biểu mẫu

**api**: localhost:9000/admin/api/v4/forms/{id}
**method**: delete


### PHÂN QUYỀN

#### Danh sách nhân viên

**api**: localhost:9000/admin/api/v4/users?type=employee
**method**: get
**param**: type

#### Nhân viên của tôi

**api**: localhost:9000/admin/api/v4/users/employee
**method**: get


#### Thêm nhân viên cho quản lý

**api**: localhost:9000/admin/api/v4/users/add/{id} // id của quản lý
**method**: post
**body**: 
```
{
    "userId": {id} , // id nhân vien
}
```



#### Xóa nhân viên cho quản lý

**api**: localhost:9000/admin/api/v4/users/remove/{id} // id của quản lý
**method**: post
**body**: 
```
{
    "userId": {id} , // id nhân vien
}
```



## CHUYỂN SẢN PHẨM VÀ KHÁCH HÀNG

### Tạo đơn
**api**: localhost:9000/admin/api/v4/trans 
**method**: post
**body**:
```
{
    "type": "product" | "client",
    "object_id": {id} // id của sp hoặc kh,
    "from_id": {id} // người chuyển
    "to_id": {id} // người nhận
    
}
```


### Accept
**api**: localhost:9000/admin/api/v4/trans?type=product
**method**: get
**param**: type: product | client 


### Accept
**api**: localhost:9000/admin/api/v4/trans/accept/{id} 
**method**: get

### Reject
**api**: localhost:9000/admin/api/v4/trans/reject/{id} 
**method**: get


### Lấy thông tin dashboard của nhân viên
**api**: localhost:9000/admin/api/v4/users/{id}/dashboard // id là id của nhân viên 
**method**: get