---
# System prepended metadata

title: TWPORT-90-1 船舶統計-現況總覽

---

- **url**: `'/tipc/ship-stat/'`

- **vsl0101 API**: `'vsl0101'
- request Payload
``` javaSctipt
{  
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號

}

```

- responese

```javascript
{ 
    currentPage: number
    list: [{
      container: number
      nonContainer: number
      tons:number
      containerTons: number // 新增欄位
      nonContainerTons: number // 新增欄位
      year: string
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
      {
        container: 9000,
        nonContainer: 5000,
        tons: 9500,
        containerTons: 9000,
        nonContainerTons: 500,
        year: '2019'
      },
      {
        container: 4500,
        nonContainer: 6000,
        tons: 11000,
        containerTons: 10000,
        nonContainerTons: 1000,
        year: '2020'
      },
      {
        container: 6000,
        nonContainer: 5000,
        tons: 8000,
        containerTons: 7000,
        nonContainerTons: 1000,
        year: '2021'
      },
      {
        container: 5000,
        nonContainer: 7000,
        tons: 10000,
        containerTons: 5000,
        nonContainerTons: 5000,
        year: '2022'
      },
      {
        container: 7800,
        nonContainer: 5500,
        tons: 11000,
        containerTons: 10000,
        nonContainerTons: 1000,
        year: '2023'
      }
        ]
    }
```

- **url**: `'/tipc/ship-stat/'`

- **vsl0102 API**: `'vsl0102'

- request Payload
``` javaSctipt
{    
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號
}

```

- responese

```javascript
{ 
    currentPage: number
    list: [{
         values:[{ 
            shipmentVal:string // 船舶總 (艘次/噸) 累計數
            shipmentPeriod: string // 船舶總 (艘次/噸) 同期增減
            shipmentRate: string // 船舶總 (艘次/噸) 成長率
            containerVal: string // 貨櫃總 (艘次/噸) 累計數
            containerPeriod: string // 貨櫃總 (艘次/噸) 同期增減
            containerRate: string // 貨櫃總 (艘次/噸) 成長率
            nonContainerVal: string // 非貨櫃總 (艘次/噸) 累計數
            nonContainerPeriod: string // 非貨櫃總 (艘次/噸) 同期增減
            nonContainerRate: string // 非貨櫃總 (艘次/噸) 成長率
        }]
        unit: string // (艘次/噸)
        time: string
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
           {
        values: [{
          shipmentVal: '7800',
          shipmentPeriod: '-13.45',
          shipmentRate: '-16.76',
          containerVal: '5500',
          containerPeriod: '-2.35',
          containerRate: '-2.23',
          nonContainerVal: '4350',
          nonContainerPeriod: '0.35',
          nonContainerRate: '0.25'
        }],
        unit: '艘次'
        time: '2023-01~2023-05'
      },
      {
        values: [{
          shipmentVal: '8000',
          shipmentPeriod: '-13.45',
          shipmentRate: '-16.76',
          containerVal: '7000',
          containerPeriod: '3.5',
          containerRate: '2.23',
          nonContainerVal: '5000',
          nonContainerPeriod: '0.35',
          nonContainerRate: '0.25'
        }],
        unit: '噸'
        time: '2023-01~2023-05'
      }
          
        ]
    }

```
- **url**: `'/tipc/ship-stat/'`

- **vsl02 API**: `'vsl02'

- request Payload
``` javaSctipt
{    
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號
}

```

- responese

```javascript
{ 
    currentPage: number
    list: [{
        name: string
        value: string
        time: string
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
       {
        name: '貨櫃輪',
        value: '15178'
        time: '2023-01~2023-05'
      },
      {
        name: '雜散貨輪',
        value: '13735'
        time: '2023-01~2023-05'
      },
      {
        name: '油化輪',
        value: '3786'
        time: '2023-01~2023-05'
      },
      {
        name: '客輪',
        value: '3361'
        time: '2023-01~2023-05'
      },
      {
        name: '其他專用輪',
        value: '8865'
        time: '2023-01~2023-05'
      }
          
        ]
    }

```

- **url**: `'/tipc/ship-stat/'`

- **VSL03 API**: `'vsl03'

- request Payload
``` javaSctipt
{    
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號
}

```

- responese

```javascript
{ 
    currentPage: number
    list: [{
        name: string
        value: string
        time: string
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
       {
        time: '2023-01~2023-05'
        values: [
          {
            values: [
              {
                month: 1,
                value: 3200
              },
              {
                month: 2,
                value: 3000
              },
              {
                month: 3,
                value: 3500

              },
              {
                month: 4,
                value: 3000
              },
              {
                month: 5,
                value: 4000
              },
              {
                month: 6,
                value: 3000
              },
              {
                month: 7,
                value: 3600
              }
            ],
            year: '2023'
          },
          {
            values: [
              {
                month: 1,
                value: 4000
              },
              {
                month: 2,
                value: 3500
              },
              {
                month: 3,
                value: 4000
              },
              {
                month: 4,
                value: 4200
              },
              {
                month: 5,
                value: 4500
              },
              {
                month: 6,
                value: 4600
              },
              {
                month: 7,
                value: 4600
              },
              {
                month: 8,
                value: 3500
              },
              {
                month: 9,
                value: 3200
              },
              {
                month: 10,
                value: 3300
              },
              {
                month: 11,
                value: 3500
              },
              {
                month: 12,
                value: 3400
              }
            ],
            year: '2022'
          },
          {
            values: [
              {
                month: 1,
                value: 4600
              },
              {
                month: 2,
                value: 4100
              },
              {
                month: 3,
                value: 4800
              },
              {
                month: 4,
                value: 4000
              },
              {
                month: 5,
                value: 4900
              },
              {
                month: 6,
                value: 4000
              },
              {
                month: 7,
                value: 4000
              },
              {
                month: 8,
                value: 4000
              },
              {
                month: 9,
                value: 4010
              },
              {
                month: 10,
                value: 4000
              },
              {
                month: 11,
                value: 4100
              },
              {
                month: 12,
                value: 4010
              }
            ],
            year: '2021'
          }
        ],
        type: 'container'
      },
      {
        time: '2023-01~2023-05'
        values: [
          {
            values: [
              {
                month: 1,
                value: 3200
              },
              {
                month: 2,
                value: 3000
              },
              {
                month: 3,
                value: 3500

              },
              {
                month: 4,
                value: 3000
              },
              {
                month: 5,
                value: 4000
              },
              {
                month: 6,
                value: 3000
              },
              {
                month: 7,
                value: 3600
              }
            ],
            year: '2023'
          },
          {
            values: [
              {
                month: 1,
                value: 4000
              },
              {
                month: 2,
                value: 3500
              },
              {
                month: 3,
                value: 4000
              },
              {
                month: 4,
                value: 4200
              },
              {
                month: 5,
                value: 4500
              },
              {
                month: 6,
                value: 4600
              },
              {
                month: 7,
                value: 4600
              },
              {
                month: 8,
                value: 3500
              },
              {
                month: 9,
                value: 3200
              },
              {
                month: 10,
                value: 3300
              },
              {
                month: 11,
                value: 3500
              },
              {
                month: 12,
                value: 3400
              }
            ],
            year: '2022'
          },
          {
            values: [
              {
                month: 1,
                value: 4600
              },
              {
                month: 2,
                value: 4100
              },
              {
                month: 3,
                value: 4800
              },
              {
                month: 4,
                value: 3000
              },
              {
                month: 5,
                value: 4900
              },
              {
                month: 6,
                value: 5000
              },
              {
                month: 7,
                value: 4000
              },
              {
                month: 8,
                value: 4000
              },
              {
                month: 9,
                value: 3010
              },
              {
                month: 10,
                value: 4000
              },
              {
                month: 11,
                value: 4100
              },
              {
                month: 12,
                value: 4010
              }
            ],
            year: '2021'
          }
        ],
        type: 'noneContainer'
      }
          
        ]
    }

```

