---
# System prepended metadata

title: Offer To Sell API
tags: [bizAdd]

---

# Offer To Sell API

###### tags: `bizAdd`
> [name=RoyHuang]

------------------------------------------------------------------------
## API 清單
No    | API          | Desc                      | 執行順序 | 執行條件
:----:|--------------|---------------------------|:-------:|--------------
~~1~~ | ~~URI-D-03~~ | ~~Prepare no login data~~ | ~~1~~   | ~~page init~~
2     | URI-D-04     | Check agent right         | 2       | when submit


------------------------------------------------------------------------
## URI-D-03 Offer To Sell Prepare no login data
- 未登入頁面時，所需顯示的資料

### Path
- /business/prepare/no-login/offer-to-sell
- method : GET
- body   : application/json;charset=UTF-8
- query  : None

### INPUT
無

### OUTPUT
```json=
{ 
  "code"      : <number> , // 代碼，0：ok、 < 0: error 使用
  "errorMsg"  : <string> , // 錯誤訊息
  "data" : {
    "sopHtmlText" : <string> , // 流程訊息 HTML
  }
}
```

欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
code     | 代碼     | number | N | 0：ok、 < 0: error 使用
errorMsg | 錯誤訊息 | string | N | 代碼 < 0 時，會紀錄錯誤訊息
data     | 資料集合 | Object | N | [未登入info(Object)](#未登入info)

#### 未登入info
欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
sopHtmlText | 流程說明(HTML結構) | string | N |


- 範例
```json=
{ 
  "code"      : 0,
  "errorMsg"  : "",
  "data" : {
    "sopHtmlText" : "<div><span style='font-family: \"Microsoft JhengHei\", Helvetica, sans-serif;'><strong><span style=\"font-size: 14pt;\">Post your selling offer, and let numbererested buyers contact you directly.</span></strong>&nbsp;</span></div><div><br></div><div><span style='font-family: \"Microsoft JhengHei\", Helvetica, sans-serif;'>Step 1: Please <u><a href=\"https://taitramember.taitra.org.tw\">sign in</a></u>.</span>&nbsp;</div><div><br></div><div><span style='font-family: \"Microsoft JhengHei\", Helvetica, sans-serif;'>Step2: Fill in&nbsp;your product, company and contact info.</span>&nbsp;</div><div><br></div><div><span style='font-family: \"Microsoft JhengHei\", Helvetica, sans-serif;'>Step3: Done! Your selling offer will appear on <a href=\"//Taiwantrade.com\">Taiwantrade.com</a> within 3 business days.</span></div><div><br><span style='font-family: \"Microsoft JhengHei\", Helvetica, sans-serif;'>You can check the latest selling offers <u><a href=\"https://trading-post.taiwantrade.com/\">here</a></u>.</span></div>\"
  }
}
```


### SQL
[參考](https://hackmd.io/kQegnS_oTGCx5MN1LOVDFQ?view#Offer-to-sell-Prepare-no-login-data)


------------------------------------------------------------------------
## URI-D-04 Offer to Sell Check agent right
- 檢查使用者是否有待刊者的權限
- 需要先取得 dynamic key

### Path
- /business/agent-right
- method : POST
- body   : application/json;charset=UTF-8
- query  : None

### INPUT
```json=
{ 
  "dynamicKey"        : "d35db44eada87cde1a6c9a35d083d703",
  "userAccessTicket"  : "asdada4b1f8c6bc4d7b6caw163453628705de5fba9ddadasdqwe274a984f33c38ed144asdqwe274a8"
}
```

欄位名稱 | 欄位說明 | 資料型態 | 是否必填 | 備註
---------|--------|----------|:--------:|-----
dynamicKey       | dynamic key      | string | Y       | 時效為5分，參考 [URI062](https://docs.google.com/spreadsheets/d/12U90GlZtqTFVemxzp5lFCv5l_eAZchVlOJN6xbRxDLI/edit#gid=0&range=A84)
userAccessTicket | 登入使用者的Ticket | string | Y       | 透過 header 取得



### OUTPUT
```json=
{ 
  "code"      : <number> , // 代碼，0：ok、 < 0: error 使用
  "errorMsg"  : <string> , // 錯誤訊息
  "data" : {
    "agentCode" : <number> , // 是否有待刊者的權限，1:Y(非台灣)、0:N(台灣)、-1:N(無國別)
  }
}
```


欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
code     | 代碼     | number | N | 0：ok、 < 0: error 使用
errorMsg | 錯誤訊息 | string | N | 代碼 < 0 時，會紀錄錯誤訊息
data     | 資料集合 | Object | N | [待刊者info(Object)](#待刊者info)


#### 待刊者info
欄位名稱 | 欄位說明 | 資料型態 | 是否空值 | 備註
---------|--------|----------|:--------:|-----
agentCode | 待刊者權限的代碼 | number  | N  | (1):Y(非台灣)、0:N(台灣)、-1:N(無國別)<br>(2).整數，int type


- 範例
```json=
{ 
  "code"      : 0,
  "errorMsg"  : "",
  "data" : {
    "agentCode" : 1
  }
}
```
### SQL
[參考](https://hackmd.io/kQegnS_oTGCx5MN1LOVDFQ?view#Offer-to-sell-Check-agent-right)