# Danh sách gian hàng

* /api/ecom/shops: Tính năng này dùng để lấy danh sách gian hàng sàn TMĐT

## Request

* Xem các [common request params](https://apidocs.nhanh.vn/v2/readme#request-params)
* Các key của mảng **data array** dùng để tạo **data** json string:

| Key   | Type | Description                                                                          |
| ----- | ---- | ------------------------------------------------------------------------------------ |
| page  | int  | Phân trang (giá trị mặc định là 1)                                                   |
| appId | int  | ID sàn TMĐT (8195 = Shopee, 8855 = Tiktok, 8142 = Lazada, 8237 = Sendo, 8238 = Tiki) |

## Response:

* JSON decode the response to get the structure:

| Key      | Type | Description                               |
| -------- | ---- | ----------------------------------------- |
| code     | int  | 1 = success or 0 = failed                 |
| messages | \[ ] | is an array of error messages if code = 0 |
| data     | \[ ] | is an array of shop list                  |

```javascript
[
    "totalPages" => int,
    "page" => int,
    "shops" => [ // maximum 100 shops per page
        // shop 1
        [
            // see properties in the table below
        ],
        ...
    ]
]
```

| Key       | Type        | Description                                                                          |
| --------- | ----------- | ------------------------------------------------------------------------------------ |
| shopId    | string (64) | ID gian hàng trên sàn TMĐT                                                           |
| appId     | int         | ID sàn TMĐT (8195 = Shopee, 8855 = Tiktok, 8142 = Lazada, 8237 = Sendo, 8238 = Tiki) |
| shopName  | string      | Tên gian hàng trên sàn TMĐT                                                          |
| createdAt | int         | Ngày tạo gian hàng trên Nhanh.vn (định dạng timestamp)                               |
| expiredAt | int         | Ngày hết hạn gian hàng trên Nhanh.vn (định dạng timestamp)                           |