|
|
- ## 创建商铺
-
-
-
- #### URL
-
- POST http://[address]/seller/create_store
-
- #### Request
- Headers:
-
- key | 类型 | 描述 | 是否可为空
- ---|---|---|---
- token | string | 登录产生的会话标识 | N
-
- Body:
-
- ```json
- {
- "user_id": "$seller id$",
- "store_id": "$store id$"
- }
- ```
-
- key | 类型 | 描述 | 是否可为空
- ---|---|---|---
- user_id | string | 卖家用户ID | N
- store_id | string | 商铺ID | N
-
- #### Response
-
- Status Code:
-
- 码 | 描述
- --- | ---
- 200 | 创建商铺成功
- 5XX | 商铺ID已存在
-
-
- ## 商家添加书籍信息
-
- #### URL:
- POST http://[address]/seller/add_book
-
- #### Request
- Headers:
-
- key | 类型 | 描述 | 是否可为空
- ---|---|---|---
- token | string | 登录产生的会话标识 | N
-
- Body:
-
- ```json
- {
- "user_id": "$seller user id$",
- "store_id": "$store id$",
- "book_info": {
- "tags": [
- "tags1",
- "tags2",
- "tags3",
- "..."
- ],
- "pictures": [
- "$Base 64 encoded bytes array1$",
- "$Base 64 encoded bytes array2$",
- "$Base 64 encoded bytes array3$",
- "..."
- ],
- "id": "$book id$",
- "title": "$book title$",
- "author": "$book author$",
- "publisher": "$book publisher$",
- "original_title": "$original title$",
- "translator": "translater",
- "pub_year": "$pub year$",
- "pages": 10,
- "price": 10,
- "binding": "平装",
- "isbn": "$isbn$",
- "author_intro": "$author introduction$",
- "book_intro": "$book introduction$",
- "content": "$chapter1 ...$"
- },
- "stock_level": 0
- }
-
- ```
-
- 属性说明:
-
- 变量名 | 类型 | 描述 | 是否可为空
- ---|---|---|---
- user_id | string | 卖家用户ID | N
- store_id | string | 商铺ID | N
- book_info | class | 书籍信息 | N
- stock_level | int | 初始库存,大于等于0 | N
-
- book_info类:
-
- 变量名 | 类型 | 描述 | 是否可为空
- ---|---|---|---
- id | string | 书籍ID | N
- title | string | 书籍题目 | N
- author | string | 作者 | Y
- publisher | string | 出版社 | Y
- original_title | string | 原书题目 | Y
- translator | string | 译者 | Y
- pub_year | string | 出版年月 | Y
- pages | int | 页数 | Y
- price | int | 价格(以分为单位) | N
- binding | string | 装帧,精状/平装 | Y
- isbn | string | ISBN号 | Y
- author_intro | string | 作者简介 | Y
- book_intro | string | 书籍简介 | Y
- content | string | 样章试读 | Y
- tags | array | 标签 | Y
- pictures | array | 照片 | Y
-
- tags和pictures:
-
- tags 中每个数组元素都是string类型
- picture 中每个数组元素都是string(base64表示的bytes array)类型
-
-
- #### Response
-
- Status Code:
-
- 码 | 描述
- --- | ---
- 200 | 添加图书信息成功
- 5XX | 卖家用户ID不存在
- 5XX | 商铺ID不存在
- 5XX | 图书ID已存在
-
-
- ## 商家添加书籍库存
-
-
- #### URL
-
- POST http://[address]/seller/add_stock_level
-
- #### Request
- Headers:
-
- key | 类型 | 描述 | 是否可为空
- ---|---|---|---
- token | string | 登录产生的会话标识 | N
-
- Body:
-
- ```json
- {
- "user_id": "$seller id$",
- "store_id": "$store id$",
- "book_id": "$book id$",
- "add_stock_level": 10
- }
- ```
- key | 类型 | 描述 | 是否可为空
- ---|---|---|---
- user_id | string | 卖家用户ID | N
- store_id | string | 商铺ID | N
- book_id | string | 书籍ID | N
- add_stock_level | int | 增加的库存量 | N
-
- #### Response
-
- Status Code:
-
- 码 | 描述
- --- | :--
- 200 | 创建商铺成功
- 5XX | 商铺ID不存在
- 5XX | 图书ID不存在
|