---
tags: 小樹購, TREEBUY, API
---

# 小樹購首頁 Banner API

## API path
- EndPoint
- UAT: https://api-at-uat.treebuy-dev.com/api
- PROD: https://api.treebuy.com/api
- Method : `GET`
- url : {EndPoint}/content/topbanner

## API 說明

### REQUEST HEADERS

Header | Description
------------ | -------------
Content-Type | application/json

### Query String

?from=CathayEmployeeEntrance

### REQUEST BODY
- 無

### API Response Format

Success Response

{
    "code": 200,
    "result": []
}

沒有傳 from 的 Response

{
    "code": 404,
    "result": {
        "data": [],
        "endpoint": "",
        "errors": {
            "code": "",
            "type": "vue-storefront api handler",
            "message": "url query from is empty"
        }
    }
}

有傳 from 但參數錯誤的 Response，Other Error Response

{
    "code": 404,
    "result": {
        "data": [],
        "endpoint": "/content/v1/topbanner",
        "errors": {
            "code": "A0",
            "type": "ResponseStatusException",
            "message": "System Error"
        }
    }
}

### Status Code

此 API HTTP Status Code , 走下列方式
| Http Code | Http Desc|
|--|--|
| 401 | 業務邏輯錯誤 |
| 200 | 成功/空資料 |
| 500 | 系統錯誤 |

## API payload example

- Desktop 圖片尺寸：
- width: 1440px
- height: 449px
- Mobile 圖片尺寸：
- width: 375px
- height: 187px

{
    "code": 200,
    "result": [
        {
            "desktop": [
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_2.jpg",
                    "href": "https://treebuy.flyelephant.com.tw/c1/-24/210428-311.html?childSku=P21042800010002&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "self"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220901.jpg",
                    "href": "",
                    "target": ""
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220501free_1.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=Apple&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220111_1.jpg",
                    "href": "https://treebuy.com/campaign-a/6?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220325_1.jpg",
                    "href": "https://at-uat.treebuy-dev.com/campaign-a/1?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220221.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=Apple&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220325.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=雅詩蘭黛&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_cwp_q2.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=Apple&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_1.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=Apple&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_3_1.jpg",
                    "href": "https://events.treebuy.com/C211125001/index.html?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220221.jpg",
                    "href": "https://treebuy.com/?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                }
            ],
            "mobile": [
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/_/1_375x187.jpg",
                    "href": "https://treebuy.flyelephant.com.tw/c4/-27?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/-/1-375x187.jpg",
                    "href": "https://treebuy.flyelephant.com.tw/?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/2/_/2_375x187.jpg",
                    "href": "https://treebuy.com/campaign-a/18?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "self"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/3/7/375x187_220415btn_1.jpg",
                    "href": "https://at-uat.treebuy-dev.com/?utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "self"
                },
                {
                    "image": "https://cdn-uat.treebuy-dev.com/mageplaza/bannerslider/banner/image/1/4/1440x449_220829a.jpg",
                    "href": "https://at-uat.treebuy-dev.com/search?q=Apple&page=1&utm_source=EmployeeEntrance&utm_medium=cathaylife&utm_campaign=pointbanner",
                    "target": "_blank"
                }
            ]
        }
    ]
}

### 時程
- 9/26 這週 UAT 交付
- 10月初上 PROD