2040 lines
64 KiB
Markdown
2040 lines
64 KiB
Markdown
# kongfz.dll 使用教程
|
||
|
||
## 1.创建DLL工具实例
|
||
|
||
### 加载DLL文件
|
||
```gotemplate
|
||
// 加载DLL的函数
|
||
type kongfzDLL struct {
|
||
dll *syscall.DLL
|
||
outLogin *syscall.Proc // 孔网登录
|
||
outGetUserMsg *syscall.Proc // 获取孔网用户信息
|
||
outGetGoodsTplMsg *syscall.Proc // 获取商品模版-已登的店铺
|
||
outGetGoodsListMsgFromSelfShop *syscall.Proc // 获取商品列表-已登的店铺
|
||
outAddGoods *syscall.Proc // 新增商品-已登的店铺
|
||
outDelGoodsFromSelfShop *syscall.Proc // 删除商品-已登的店铺
|
||
outGetImageFilterShopId *syscall.Proc // 获取孔网商品图片(官图和拍图)-带有店铺过滤
|
||
outGetImageByIsbn *syscall.Proc // 获取孔网商品图片和信息(官图和拍图)
|
||
outGetGoodsListMsgByShopId *syscall.Proc // 获取商品列表通过店铺ID
|
||
outGetGoodsMsgByDetailUrl *syscall.Proc // 获取商品信息通过商品详情链接
|
||
outGetTopGoodsListMsg *syscall.Proc // 获取销量榜商品列表
|
||
freeCString *syscall.Proc // 释放C字符串内存
|
||
}
|
||
|
||
// 初始化kongfzDLL
|
||
func InitKongfzDLL() (*kongfzDLL, error) {
|
||
dllPath := filepath.Join("dll", "kongfz.dll")
|
||
if _, err := os.Stat(dllPath); os.IsNotExist(err) {
|
||
return nil, fmt.Errorf("kongfz DLL 不存在: %s", dllPath)
|
||
}
|
||
if dll, err := syscall.LoadDLL(dllPath); err != nil {
|
||
return nil, fmt.Errorf("加载 kongfz DLL 失败: %v", err)
|
||
} else {
|
||
return &kongfzDLL{
|
||
dll: dll,
|
||
outLogin: dll.MustFindProc("OutLogin"),
|
||
outGetUserMsg: dll.MustFindProc("OutGetUserMsg"),
|
||
outGetGoodsTplMsg: dll.MustFindProc("OutGetGoodsTplMsg"),
|
||
outGetGoodsListMsgFromSelfShop: dll.MustFindProc("OutGetGoodsListMsgFromSelfShop"),
|
||
outAddGoods: dll.MustFindProc("OutAddGoods"),
|
||
outDelGoodsFromSelfShop: dll.MustFindProc("OutDelGoodsFromSelfShop"),
|
||
outGetImageFilterShopId: dll.MustFindProc("OutGetImageFilterShopId"),
|
||
outGetImageByIsbn: dll.MustFindProc("OutGetImageByIsbn"),
|
||
outGetGoodsListMsgByShopId: dll.MustFindProc("OutGetGoodsListMsgByShopId"),
|
||
outGetGoodsMsgByDetailUrl: dll.MustFindProc("OutGetGoodsMsgByDetailUrl"),
|
||
outGetTopGoodsListMsg: dll.MustFindProc("OutGetTopGoodsListMsg"),
|
||
freeCString: dll.MustFindProc("FreeCString"),
|
||
}, nil
|
||
}
|
||
}
|
||
|
||
// main函数调用
|
||
dll, err := InitKongfzDLL()
|
||
if err != nil {
|
||
fmt.Println(err)
|
||
}
|
||
```
|
||
|
||
### 获取C字符串
|
||
```gotemplate
|
||
// cStr 获取C字符串
|
||
func (m *kongfzDLL) cStr(p uintptr) string {
|
||
if p == 0 {
|
||
return ""
|
||
}
|
||
b := []byte{}
|
||
for i := uintptr(0); ; i++ {
|
||
c := *(*byte)(unsafe.Pointer(p + i))
|
||
if c == 0 {
|
||
break
|
||
}
|
||
b = append(b, c)
|
||
}
|
||
s := string(b)
|
||
if m.freeCString != nil {
|
||
m.freeCString.Call(p)
|
||
}
|
||
return s
|
||
}
|
||
```
|
||
|
||
### 2.使用dll函数示例
|
||
```gotemplate
|
||
// 获取商品模版
|
||
func (m *kongfzDLL) OutGetGoodsTplMsg(token, itemId, proxy string) (string, error) {
|
||
proc, err := m.dll.FindProc("OutGetGoodsTplMsg")
|
||
if err != nil {
|
||
return "", fmt.Errorf("找不到函数 OutGetGoodsTplMsg 函数: %v", err)
|
||
}
|
||
tokenPtr, _ := syscall.BytePtrFromString(token)
|
||
itemIdPtr, _ := syscall.BytePtrFromString(itemId)
|
||
proxyPtr, _ := syscall.BytePtrFromString(proxy)
|
||
info, _, err := proc.Call(
|
||
uintptr(unsafe.Pointer(tokenPtr)),
|
||
uintptr(unsafe.Pointer(itemIdPtr)),
|
||
uintptr(unsafe.Pointer(proxyPtr)))
|
||
if err != nil && err.Error() != "The operation completed successfully." {
|
||
return "", fmt.Errorf("调用函数 OutGetGoodsTplMsg 失败: %v", err)
|
||
}
|
||
return m.cStr(info), nil
|
||
}
|
||
```
|
||
|
||
### 初始化配置信息(可以不调用)
|
||
```gotemplate
|
||
func main() {
|
||
// 使用默认配置初始化
|
||
config := createDefaultConfig()
|
||
configJSON, err := json.Marshal(config)
|
||
if err != nil {
|
||
log.Fatalf("序列化配置失败: %v", err)
|
||
}
|
||
|
||
result, err := manager.Initialize(string(configJSON))
|
||
if err != nil {
|
||
log.Fatalf("初始化失败: %v", err)
|
||
}
|
||
|
||
var initResp APIResponse
|
||
if err := json.Unmarshal([]byte(result), &initResp); err != nil {
|
||
log.Fatalf("解析初始化响应失败: %v", err)
|
||
}
|
||
|
||
if !initResp.Success {
|
||
log.Fatalf("初始化失败: %s", initResp.Message)
|
||
}
|
||
}
|
||
|
||
// 创建默认配置
|
||
func createDefaultConfig() Config {
|
||
var config Config
|
||
// App配置
|
||
config.App.MaxRetryTimes = 3
|
||
config.App.RateLimitDelay = 1000
|
||
config.App.Size = 10
|
||
config.App.DefaultUserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
|
||
|
||
// API配置
|
||
config.API.LoginURL = "https://login.kongfz.com/Pc/Login/account"
|
||
config.API.BookSearchURL = "https://search.kongfz.com/pc-gw/search-web/client/pc/bookLib/keyword/list"
|
||
config.API.ProductSearchURL = "https://search.kongfz.com/pc-gw/search-web/client/pc/product/keyword/list"
|
||
|
||
// 代理配置（需要根据实际情况修改）
|
||
config.Proxy.Servers = "http-dynamic.xiaoxiangdaili.com,http-dynamic-S02.xiaoxiangdaili.com,http-dynamic-S03.xiaoxiangdaili.com,http-dynamic-S04.xiaoxiangdaili.com"
|
||
config.Proxy.Username = "1297757178467602432"
|
||
config.Proxy.Password = "QgQBvP7f"
|
||
config.Proxy.TailMachineCode = "b7bf22a237ec692f13fcc2c43ee63252"
|
||
config.Proxy.TailCardKey = "DL_20_YK_1920acb2129844c2aabade3896560a9b"
|
||
config.Proxy.ProxyFilePath = "dll/proxyConfig.dll"
|
||
|
||
config.Database.Username = "newAdmin"
|
||
config.Database.Password = "bYPp8SbBe5F7nz2i"
|
||
config.Database.Host = "146.56.227.42:3306"
|
||
config.Database.Name = "newadmin"
|
||
return config
|
||
}
|
||
```
|
||
|
||
## 2.配置结构体(可以不调用)
|
||
```gotemplate
|
||
type Config struct {
|
||
App struct {
|
||
MaxRetryTimes int `json:"max_retry_times"`
|
||
RateLimitDelay int `json:"rate_limit_delay"`
|
||
Size int `json:"size"`
|
||
DefaultUserAgent string `json:"default_user_agent"`
|
||
} `json:"app"`
|
||
|
||
API struct {
|
||
LoginURL string `json:"login_url"`
|
||
BookSearchURL string `json:"book_search_url"`
|
||
ProductSearchURL string `json:"product_search_url"`
|
||
} `json:"api"`
|
||
|
||
Proxy struct {
|
||
Servers string `json:"servers"`
|
||
Username string `json:"username"`
|
||
Password string `json:"password"`
|
||
TailMachineCode string `json:"tail_machine_code"`
|
||
TailCardKey string `json:"tail_card_key"`
|
||
ProxyFilePath string `json:"proxy_file_path"`
|
||
} `json:"proxy"`
|
||
}
|
||
```
|
||
|
||
# 接口详情
|
||
## 1.孔网登录--OutLogin
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutLogin(username, password)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|--|--|
|
||
| username | string | 是 | 登录用户名 |
|
||
| password | string | 是 | 登录密码 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"token": "abc123def456"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 2.获取孔网用户信息--OutGetUserMsg
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetUserMsg(token)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|--|--|
|
||
| token | string | 是 | 登录凭证 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"userId": 123456,
|
||
"nickname": "用户昵称",
|
||
"mobile": "13800138000"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 3.获取商品模版-已登的店铺--OutGetGoodsTplMsg
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetGoodsTplMsg(token, proxy, itemId)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|--|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| itemId | string | 是 | 商品ID |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"status": 1,
|
||
"data": {
|
||
"categorySection": {
|
||
"key": "catId",
|
||
"name": "分类",
|
||
"value": "58012000000000000",
|
||
"catName": "收藏杂项 > 其他杂项",
|
||
"inputType": "other",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "categorySelect",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
},
|
||
"isValid": true
|
||
},
|
||
"goodsSection": [
|
||
{
|
||
"key": "itemName",
|
||
"name": "商品名称",
|
||
"value": "鎏金降魔杵 全品",
|
||
"inputType": "textarea",
|
||
"title": "请填写商品名称",
|
||
"tips": "请填写商品名称",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"maxLen": 200
|
||
}
|
||
},
|
||
{
|
||
"key": "author",
|
||
"name": "制作者",
|
||
"value": "未知",
|
||
"inputType": "text",
|
||
"title": "请填写制作者",
|
||
"tips": "请填写制作者",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"maxLen": 120
|
||
}
|
||
},
|
||
{
|
||
"key": "yearsGroup",
|
||
"name": "年代",
|
||
"value": "2",
|
||
"inputType": "yearsGroup",
|
||
"title": "请填写时间或选择年代",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "radio",
|
||
"status": 0,
|
||
"isRequired": 0
|
||
},
|
||
"options": [
|
||
{
|
||
"name": "填写时间",
|
||
"value": "1",
|
||
"group": [
|
||
{
|
||
"key": "pubDate",
|
||
"name": "年代",
|
||
"value": "",
|
||
"inputType": "dateGroup",
|
||
"title": "请填写年代",
|
||
"tips": "请填写年代",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "date",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"enableUnknow": false,
|
||
"maxDate": "2026-12"
|
||
},
|
||
"group": [
|
||
{
|
||
"key": "pubDateYear",
|
||
"name": "年份",
|
||
"value": "",
|
||
"leftWords": "hidden",
|
||
"inputType": "int",
|
||
"title": "请填写年份",
|
||
"tips": "请填写年份",
|
||
"unit": "年",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "int",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"min": 0,
|
||
"max": 2026
|
||
}
|
||
},
|
||
{
|
||
"key": "pubDateMonth",
|
||
"name": "月份",
|
||
"value": "",
|
||
"leftWords": "hidden",
|
||
"inputType": "int",
|
||
"title": "请填写月份",
|
||
"tips": "请填写月份",
|
||
"unit": "月",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "int",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"min": 1,
|
||
"max": 12
|
||
}
|
||
}
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "选择年代",
|
||
"value": "2",
|
||
"group": [
|
||
{
|
||
"key": "years",
|
||
"name": "年代",
|
||
"value": 0,
|
||
"inputType": "yearsSelect",
|
||
"title": "请选择年代",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "yearsSelect",
|
||
"status": 0,
|
||
"isRequired": 0
|
||
}
|
||
}
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"key": "material",
|
||
"name": "材质",
|
||
"value": "金属",
|
||
"inputType": "text",
|
||
"title": "请填写材质",
|
||
"tips": "请填写材质",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"maxLen": 10
|
||
}
|
||
},
|
||
{
|
||
"key": "size",
|
||
"name": "尺寸",
|
||
"value": "",
|
||
"inputType": "row",
|
||
"isRequired": 0,
|
||
"title": "请填写尺寸",
|
||
"tips": "请填写尺寸",
|
||
"group": [
|
||
{
|
||
"key": "sizeLength",
|
||
"name": "长度",
|
||
"value": "6",
|
||
"leftWords": "长",
|
||
"inputType": "float",
|
||
"title": "请填写长度",
|
||
"tips": "请填写长度",
|
||
"unit": "cm",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"min": 0.01,
|
||
"max": 99999.99,
|
||
"decimals": 2
|
||
}
|
||
},
|
||
{
|
||
"key": "sizeWidth",
|
||
"name": "宽度",
|
||
"value": "2",
|
||
"leftWords": "宽",
|
||
"inputType": "float",
|
||
"title": "请填写宽度",
|
||
"tips": "请填写宽度",
|
||
"unit": "cm",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"min": 0.01,
|
||
"max": 99999.99,
|
||
"decimals": 2
|
||
}
|
||
},
|
||
{
|
||
"key": "sizeHeight",
|
||
"name": "高度",
|
||
"value": "3",
|
||
"leftWords": "高",
|
||
"inputType": "float",
|
||
"title": "请填写高度",
|
||
"tips": "请填写高度",
|
||
"unit": "cm",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"min": 0.01,
|
||
"max": 99999.99,
|
||
"decimals": 2
|
||
}
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"key": "quality",
|
||
"name": "品相",
|
||
"value": "95",
|
||
"inputType": "select",
|
||
"options": [
|
||
{
|
||
"name": "全新",
|
||
"value": 100
|
||
},
|
||
{
|
||
"name": "九五品",
|
||
"value": 95
|
||
},
|
||
{
|
||
"name": "九品",
|
||
"value": 90
|
||
},
|
||
{
|
||
"name": "八五品",
|
||
"value": 85
|
||
},
|
||
{
|
||
"name": "八品",
|
||
"value": 80
|
||
},
|
||
{
|
||
"name": "七五品",
|
||
"value": 75
|
||
},
|
||
{
|
||
"name": "七品",
|
||
"value": 70
|
||
},
|
||
{
|
||
"name": "六五品",
|
||
"value": 65
|
||
},
|
||
{
|
||
"name": "六品",
|
||
"value": 60
|
||
},
|
||
{
|
||
"name": "五品",
|
||
"value": 50
|
||
},
|
||
{
|
||
"name": "四品",
|
||
"value": 40
|
||
},
|
||
{
|
||
"name": "三品",
|
||
"value": 30
|
||
},
|
||
{
|
||
"name": "二品",
|
||
"value": 20
|
||
},
|
||
{
|
||
"name": "一品",
|
||
"value": 10
|
||
}
|
||
],
|
||
"title": "请选择品相",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "select",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
}
|
||
},
|
||
{
|
||
"key": "qualityDesc",
|
||
"name": "品相描述",
|
||
"value": "老好了",
|
||
"inputType": "textarea",
|
||
"title": "请填写品相描述",
|
||
"tips": "请填写品相描述",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"maxLen": 400
|
||
}
|
||
},
|
||
{
|
||
"key": "price",
|
||
"name": "售价",
|
||
"value": "1467.00",
|
||
"leftWords": "",
|
||
"inputType": "float",
|
||
"title": "请填写售价",
|
||
"tips": "请填写售价",
|
||
"unit": "元",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"min": 0.01,
|
||
"max": 99999999.99,
|
||
"decimals": 2
|
||
}
|
||
},
|
||
{
|
||
"key": "number",
|
||
"name": "库存数量",
|
||
"value": "1",
|
||
"leftWords": "",
|
||
"inputType": "int",
|
||
"title": "请填写库存数量",
|
||
"tips": "请填写库存数量",
|
||
"unit": "件",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "int",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"min": 0,
|
||
"max": 9999
|
||
}
|
||
},
|
||
{
|
||
"key": "itemSn",
|
||
"name": "货号",
|
||
"value": "",
|
||
"inputType": "text",
|
||
"title": "请填写货号",
|
||
"tips": "请填写货号",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"maxLen": 20
|
||
}
|
||
},
|
||
{
|
||
"key": "myCatId",
|
||
"name": "本店分类",
|
||
"value": "",
|
||
"inputType": "select",
|
||
"options": [],
|
||
"title": "请选择本店分类",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "select",
|
||
"status": 0,
|
||
"isRequired": 0
|
||
}
|
||
},
|
||
{
|
||
"key": "itemDesc",
|
||
"name": "详细描述",
|
||
"value": "",
|
||
"inputType": "textarea",
|
||
"title": "请填写详细描述",
|
||
"tips": "请填写详细描述",
|
||
"unit": "",
|
||
"explain": "",
|
||
"check": {
|
||
"type": "string",
|
||
"status": 0,
|
||
"isRequired": 0,
|
||
"maxLen": 10000
|
||
}
|
||
},
|
||
{
|
||
"key": "images",
|
||
"name": "图片",
|
||
"inputType": "images",
|
||
"title": "请填写图片",
|
||
"tips": "图片格式为jpg、png、gif、jpeg，图片大小不能超过10M，一次可以选择多张上传，最多上传30张，拖拽调整顺序。",
|
||
"unit": "",
|
||
"value": "",
|
||
"images": [
|
||
{
|
||
"imgId": 239722,
|
||
"imgType": 0,
|
||
"isMain": 1,
|
||
"imgUrl": "sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_s.jpg",
|
||
"imgSrc": "https://www0.kfzimg.com/sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_s.jpg",
|
||
"imgSrcMiddle": "https://www0.kfzimg.com/sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_n.jpg",
|
||
"imgSrcBig": "https://www0.kfzimg.com/sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_b.jpg",
|
||
"imgDesc": "",
|
||
"imgTag": []
|
||
}
|
||
],
|
||
"batchKey": "img",
|
||
"check": {
|
||
"type": "images",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"descMaxLen": 300,
|
||
"minNum": 1,
|
||
"maxNum": 30,
|
||
"appMaxSize": "2MB",
|
||
"appMaxWidth": "1200",
|
||
"pcMaxSize": "10MB"
|
||
}
|
||
},
|
||
{
|
||
"key": "isOnSale",
|
||
"name": "货架状态",
|
||
"value": "1",
|
||
"inputType": "radio",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "radio",
|
||
"status": -1,
|
||
"isRequired": 1
|
||
},
|
||
"options": [
|
||
{
|
||
"name": "直接上架",
|
||
"value": "1"
|
||
},
|
||
{
|
||
"name": "暂时下架",
|
||
"value": "0"
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"key": "itemId",
|
||
"name": "商品编号",
|
||
"value": 9250897118,
|
||
"inputType": "hidden",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": ""
|
||
},
|
||
{
|
||
"key": "oldCatId",
|
||
"name": "原商品分类",
|
||
"value": "58012000000000000",
|
||
"inputType": "hidden",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": ""
|
||
},
|
||
{
|
||
"key": "oldPrice",
|
||
"name": "原商品价格",
|
||
"value": "1467.00",
|
||
"inputType": "hidden",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": ""
|
||
},
|
||
{
|
||
"key": "tpl",
|
||
"name": "模板编号",
|
||
"value": 12,
|
||
"inputType": "hidden",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": ""
|
||
}
|
||
],
|
||
"deliverSection": [
|
||
{
|
||
"key": "deliverTimeGroup",
|
||
"name": "发货模式",
|
||
"value": "1",
|
||
"inputType": "ridio",
|
||
"title": "发货模式",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "radio",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
},
|
||
"options": [
|
||
{
|
||
"name": "现货模式",
|
||
"value": "1",
|
||
"key": "deliverTypeInStock",
|
||
"group": [
|
||
{
|
||
"key": "deliverTime",
|
||
"name": "发货时间",
|
||
"value": "48h",
|
||
"inputType": "radio",
|
||
"title": "发货时间",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "radio",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
},
|
||
"options": [
|
||
{
|
||
"name": "当日发",
|
||
"value": "today",
|
||
"tips": "买家在16点前付款当日24点前发货；16点后付款次日24点前发货；且在发货24小时内返回物流轨迹。"
|
||
},
|
||
{
|
||
"name": "24小时",
|
||
"value": "24h",
|
||
"tips": "买家付款后24小时内发货，且在发货24小时内返回物流轨迹。"
|
||
},
|
||
{
|
||
"name": "48小时",
|
||
"value": "48h"
|
||
}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"key": "isDeliverTimeDefault",
|
||
"name": "设为默认发货时间",
|
||
"value": "48h",
|
||
"inputType": "hidden"
|
||
}
|
||
],
|
||
"shippingSection": [
|
||
{
|
||
"key": "bearShipping",
|
||
"name": "",
|
||
"value": "buyer",
|
||
"inputType": "radio",
|
||
"options": [
|
||
{
|
||
"name": "卖家承担运费",
|
||
"tips": "(必须支持快递)",
|
||
"value": "seller"
|
||
},
|
||
{
|
||
"name": "运费模板",
|
||
"value": "buyer"
|
||
}
|
||
],
|
||
"title": "请选择",
|
||
"tips": "",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "radio",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
}
|
||
},
|
||
{
|
||
"key": "isUseMould",
|
||
"name": "是否使用运费模板",
|
||
"value": "1",
|
||
"inputType": "hidden",
|
||
"title": "",
|
||
"tips": "",
|
||
"unit": ""
|
||
},
|
||
{
|
||
"key": "mouldId",
|
||
"name": "运费模板",
|
||
"value": 975623,
|
||
"inputType": "select",
|
||
"title": "请选择运费模板",
|
||
"tips": "为了提升消费者购物体验，方便您计算运费，买家承担运费的商品均需使用运费模板，如何使用模板，[url=]查看视频教程[/url]",
|
||
"unit": "",
|
||
"check": {
|
||
"type": "shippingMouldSelect",
|
||
"status": 0,
|
||
"isRequired": 1
|
||
},
|
||
"shipping": [],
|
||
"shopProductArea": 1001000000,
|
||
"mouldList": [
|
||
{
|
||
"mouldId": "975623",
|
||
"mouldName": "模板1",
|
||
"isTransfer": "0",
|
||
"isDefault": "0",
|
||
"isAppMould": "0",
|
||
"feeManner": "weight",
|
||
"productArea": "1001000000",
|
||
"mouldInfo": {
|
||
"mouldId": "975623",
|
||
"userId": "24175337",
|
||
"mouldName": "模板1",
|
||
"productArea": "1001000000",
|
||
"feeManner": "weight",
|
||
"sortOrder": [
|
||
"express"
|
||
],
|
||
"enableShipping": "express",
|
||
"dataMd5": "",
|
||
"isDefault": "0",
|
||
"isAppMould": "0",
|
||
"description": "",
|
||
"smartMouldId": "0",
|
||
"shipmentType": "0",
|
||
"provId": "1000000000",
|
||
"provName": "北京",
|
||
"cityId": "1001000000",
|
||
"cityName": "东城",
|
||
"feeList": {
|
||
"express": {
|
||
"enabled": true,
|
||
"name": "快递",
|
||
"special": [
|
||
{
|
||
"feeId": 8587228,
|
||
"area": [
|
||
{
|
||
"provId": "1000000000",
|
||
"provName": "北京",
|
||
"cities": []
|
||
}
|
||
],
|
||
"areaDivide": "china",
|
||
"initialNum": 1,
|
||
"addNum": 1,
|
||
"addFee": "5.00",
|
||
"initialFee": "5.00",
|
||
"registerFee": "0.00"
|
||
},
|
||
{
|
||
"feeId": 8587229,
|
||
"area": [
|
||
{
|
||
"provId": "3000000000",
|
||
"provName": "天津",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "12000000000",
|
||
"provName": "河北",
|
||
"cities": []
|
||
}
|
||
],
|
||
"areaDivide": "china",
|
||
"initialNum": 1,
|
||
"addNum": 1,
|
||
"addFee": "5.00",
|
||
"initialFee": "5.00",
|
||
"registerFee": "0.00"
|
||
},
|
||
{
|
||
"feeId": 8587230,
|
||
"area": [
|
||
{
|
||
"provId": "2000000000",
|
||
"provName": "上海",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "18000000000",
|
||
"provName": "江苏",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "31000000000",
|
||
"provName": "浙江",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "5000000000",
|
||
"provName": "安徽",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "19000000000",
|
||
"provName": "江西",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "25000000000",
|
||
"provName": "山西",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "24000000000",
|
||
"provName": "山东",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "21000000000",
|
||
"provName": "内蒙古",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "16000000000",
|
||
"provName": "湖南",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "15000000000",
|
||
"provName": "湖北",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "13000000000",
|
||
"provName": "河南",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "8000000000",
|
||
"provName": "广东",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "9000000000",
|
||
"provName": "广西",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "6000000000",
|
||
"provName": "福建",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "11000000000",
|
||
"provName": "海南",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "20000000000",
|
||
"provName": "辽宁",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "17000000000",
|
||
"provName": "吉林",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "14000000000",
|
||
"provName": "黑龙江",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "26000000000",
|
||
"provName": "陕西",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "7000000000",
|
||
"provName": "甘肃",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "22000000000",
|
||
"provName": "宁夏",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "23000000000",
|
||
"provName": "青海",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "4000000000",
|
||
"provName": "重庆",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "30000000000",
|
||
"provName": "云南",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "10000000000",
|
||
"provName": "贵州",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "27000000000",
|
||
"provName": "四川",
|
||
"cities": []
|
||
}
|
||
],
|
||
"areaDivide": "china",
|
||
"initialNum": 1,
|
||
"addNum": 1,
|
||
"addFee": "5.00",
|
||
"initialFee": "5.00",
|
||
"registerFee": "0.00"
|
||
},
|
||
{
|
||
"feeId": 8587231,
|
||
"area": [
|
||
{
|
||
"provId": "29000000000",
|
||
"provName": "新疆",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "28000000000",
|
||
"provName": "西藏",
|
||
"cities": []
|
||
}
|
||
],
|
||
"areaDivide": "china",
|
||
"initialNum": 1,
|
||
"addNum": 1,
|
||
"addFee": "30.00",
|
||
"initialFee": "30.00",
|
||
"registerFee": "0.00"
|
||
},
|
||
{
|
||
"feeId": 8587232,
|
||
"area": [
|
||
{
|
||
"provId": "34000000000",
|
||
"provName": "香港",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "32000000000",
|
||
"provName": "澳门",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "33000000000",
|
||
"provName": "台湾",
|
||
"cities": []
|
||
},
|
||
{
|
||
"provId": "40000000000",
|
||
"provName": "海外",
|
||
"cities": []
|
||
}
|
||
],
|
||
"areaDivide": "outChinaDefault",
|
||
"initialNum": 0,
|
||
"addNum": 0,
|
||
"addFee": "0.00",
|
||
"initialFee": "0.00",
|
||
"registerFee": 0
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"shipmentType": "0"
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"key": "weight",
|
||
"name": "物流重量",
|
||
"value": "0.5",
|
||
"leftWords": "",
|
||
"inputType": "float",
|
||
"title": "请填写物流重量",
|
||
"tips": "请填写物流重量",
|
||
"unit": "千克",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"min": 0.01,
|
||
"max": 9999.99,
|
||
"decimals": 2
|
||
}
|
||
},
|
||
{
|
||
"key": "weightPiece",
|
||
"name": "物流标准本数",
|
||
"value": "1",
|
||
"leftWords": "",
|
||
"inputType": "float",
|
||
"title": "请填写物流标准本数",
|
||
"tips": "请填写物流标准本数",
|
||
"unit": "本",
|
||
"check": {
|
||
"type": "float",
|
||
"status": 0,
|
||
"isRequired": 1,
|
||
"min": 0.01,
|
||
"max": 9999.99,
|
||
"decimals": 2
|
||
}
|
||
}
|
||
],
|
||
"isDraft": 0
|
||
},
|
||
"message": "",
|
||
"errType": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
## 4.获取商品列表-已登的店铺--OutGetGoodsListMsgFromSelfShop
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetGoodsListMsgFromSelfShop(token, proxy, itemSn, priceMin, priceMax,
|
||
startCreateTime, endCreateTime, requestType,
|
||
isItemSnEqual, page, size)
|
||
```
|
||
### 请求参数
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|-----------------|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| itemSn | string | 是 | 店铺货号 |
|
||
| priceMin | string | 否 | 最低价格 |
|
||
| priceMax | string | 否 | 最高价格 |
|
||
| startCreateTime | string | 否 | 上书开始时间 |
|
||
| endCreateTime | string | 否 | 上书结束时间 |
|
||
| requestType | string | 是 | 请求类型 onSale:出售中 |
|
||
| isItemSnEqual | int | 是 | 验证货号 填 0 就行 |
|
||
| page | int | 是 | 页码 |
|
||
| size | int | 是 | 每页数量 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"status": true,
|
||
"errCode": 0,
|
||
"errMessage": "",
|
||
"result": {
|
||
"productInfoPageResult": {
|
||
"list": [
|
||
{
|
||
"name": "鎏金降魔杵 全品",
|
||
"qualityName": "九五品",
|
||
"quality": 95,
|
||
"price": 1467.00,
|
||
"realPrice": 1467.00,
|
||
"number": 1,
|
||
"mouldName": "模板1",
|
||
"feeManner": "0.5千克",
|
||
"weight": 0.5,
|
||
"weightPiece": 0.0,
|
||
"mouldId": 975623,
|
||
"imageUrl": "https://www0.kfzimg.com/sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_s.jpg",
|
||
"imageSrc": "https://www0.kfzimg.com/sw/kfz-cos/kfzimg/24175337/00fff0d9a9dbb89c_s.jpg",
|
||
"createTime": "2025-12-11 11:42",
|
||
"updateTime": "2025-12-11 11:43",
|
||
"itemId": 9250897118,
|
||
"catId": 58012000000000000,
|
||
"catName": "收藏杂项 > 其他杂项",
|
||
"tpl": 12,
|
||
"itemSn": "",
|
||
"discount": 100,
|
||
"certifyStatus": "certified",
|
||
"isOnSale": 1,
|
||
"certifyStatusName": "出售中",
|
||
"soldNumber": null,
|
||
"soldAmount": null,
|
||
"soldTime": null,
|
||
"operateList": null,
|
||
"shareInfo": null,
|
||
"isSyncISBN": 0,
|
||
"deliverType": 1,
|
||
"deliverTime": "48h",
|
||
"isDraft": 0
|
||
}
|
||
],
|
||
"pager": {
|
||
"page": 1,
|
||
"size": 100,
|
||
"total": 1,
|
||
"pages": 1
|
||
}
|
||
},
|
||
"productStatCount": {
|
||
"allUnSold": 3,
|
||
"onSale": 1,
|
||
"zeroStock": 0,
|
||
"offSale": 2,
|
||
"needApproved": 0,
|
||
"soldCount": null
|
||
},
|
||
"productListStat": {
|
||
"count": 1,
|
||
"itemNum": 1,
|
||
"amount": "1467.00"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 5.新增商品-已登的店铺--OutAddGoods
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutAddGoods(token, proxy, formData)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|----------------|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| formData | string | 是 | 新增商品信息的json字符串 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"status":1,
|
||
"data":9279010923,
|
||
"message":"",
|
||
"errType":""
|
||
}
|
||
}
|
||
```
|
||
|
||
## 6.删除商品-已登的店铺--OutDelGoodsFromSelfShop
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutDelGoodsFromSelfShop(token, proxy, itemId)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|------|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| itemId | string | 是 | 店铺ID |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"status":true,
|
||
"errCode":0,
|
||
"errMessage":"",
|
||
"result":true
|
||
}
|
||
}
|
||
```
|
||
|
||
## 7.获取孔网商品图片(官图和拍图)-带有店铺过滤--OutGetImageFilterShopId
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetImageFilterShopId(token, proxy, isbn, shopId, isLiveImage, isReturnMsg)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|----------------------|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| isbn | string | 是 | ISBN |
|
||
| shopId | int | 是 | 店铺ID |
|
||
| isLiveImage | int | 是 | 需要官图还是实拍图 0:官图 1:实拍图 |
|
||
| isReturnMsg | int | 否 | 是否需要详细信息 0:是 1:否 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"book_name": "",
|
||
"book_pic": "",
|
||
"book_pic_s": "",
|
||
"isbn": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
## 8.获取孔网商品图片和信息(官图和拍图)--OutGetImageByIsbn
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetImageByIsbn(token, proxy,isbn, isLiveImage, isReturnMsg)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|----------------------|
|
||
| token | string | 是 | 登录凭证 |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| isbn | string | 是 | ISBN |
|
||
| isLiveImage | int | 是 | 需要官图还是实拍图 0:官图 1:实拍图 |
|
||
| isReturnMsg | int | 是 | 是否需要详细信息 0:是 1:否 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"author": "",
|
||
"publisher": "",
|
||
"isbn": "",
|
||
"publication_time": 0,
|
||
"edition": "",
|
||
"print_time": "",
|
||
"fix_price": "",
|
||
"binding_layout": "",
|
||
"format": "",
|
||
"paper": "",
|
||
"pages": "",
|
||
"wordage": "",
|
||
"languages": "",
|
||
"era": "",
|
||
"engraving_method": "",
|
||
"dimensions": "",
|
||
"volume_number": "",
|
||
"book_pic": "",
|
||
"book_pic_s": "",
|
||
"selling_price": "",
|
||
"condition": "",
|
||
"express_delivery_fee": "",
|
||
"editor": "",
|
||
"category": "",
|
||
"buy_count": "",
|
||
"sell_count": "",
|
||
"content": "",
|
||
"mid": 0,
|
||
"item_id": 0,
|
||
"shop_id": 0,
|
||
"detail_url": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
## 9.获取商品列表通过店铺ID--OutGetGoodsListMsgByShopId
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetGoodsListMsgByShopId(
|
||
shopId, proxy, retPrice, isImage, sortType,
|
||
sort, priceMin, priceMax, pageNum, returnNum)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|---|--|
|
||
| shopId | int | 是 | 店铺ID |
|
||
| proxy | string | 否 | 代理地址 |
|
||
| retPrice | int | 否 | 是否返回价格 |
|
||
| isImage | int | 否 | 是否有图片 |
|
||
| sortType | string | 否 | 排序类型 |
|
||
| sort | string | 否 | 排序方式 |
|
||
| priceMin | float | 否 | 最低价格 |
|
||
| priceMax | float | 否 | 最高价格 |
|
||
| pageNum | int | 否 | 页码 |
|
||
| returnNum | int | 否 | 每页数量 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"goods_num": "",
|
||
"pnum": "",
|
||
"book_info": [{
|
||
"author": "",
|
||
"publisher": "",
|
||
"isbn": "",
|
||
"publication_time": 0,
|
||
"edition": "",
|
||
"print_time": "",
|
||
"fix_price": "",
|
||
"binding_layout": "",
|
||
"format": "",
|
||
"paper": "",
|
||
"pages": "",
|
||
"wordage": "",
|
||
"languages": "",
|
||
"era": "",
|
||
"engraving_method": "",
|
||
"dimensions": "",
|
||
"volume_number": "",
|
||
"book_pic": "",
|
||
"book_pic_s": "",
|
||
"selling_price": "",
|
||
"condition": "",
|
||
"express_delivery_fee": "",
|
||
"editor": "",
|
||
"category": "",
|
||
"buy_count": "",
|
||
"sell_count": "",
|
||
"content": "",
|
||
"mid": 0,
|
||
"item_id": 0,
|
||
"shop_id": 0,
|
||
"detail_url": ""
|
||
}]
|
||
}
|
||
}
|
||
```
|
||
|
||
## 10.获取商品信息通过商品详情链接--OutGetGoodsMsgByDetailUrl
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetGoodsMsgByDetailUrl(detailUrl,proxy)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|---|-----------|
|
||
| detailUrl | string | 是 | 请求详情页的url |
|
||
| proxy | string | 否 | 代理地址 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"author": "",
|
||
"publisher": "",
|
||
"isbn": "",
|
||
"publication_time": 0,
|
||
"edition": "",
|
||
"print_time": "",
|
||
"fix_price": "",
|
||
"binding_layout": "",
|
||
"format": "",
|
||
"paper": "",
|
||
"pages": "",
|
||
"wordage": "",
|
||
"languages": "",
|
||
"era": "",
|
||
"engraving_method": "",
|
||
"dimensions": "",
|
||
"volume_number": "",
|
||
"book_pic": "",
|
||
"book_pic_s": "",
|
||
"selling_price": "",
|
||
"condition": "",
|
||
"express_delivery_fee": "",
|
||
"editor": "",
|
||
"category": "",
|
||
"buy_count": "",
|
||
"sell_count": "",
|
||
"content": "",
|
||
"mid": 0,
|
||
"item_id": 0,
|
||
"shop_id": 0,
|
||
"detail_url": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
## 11.获取销量榜商品列表--OutGetTopGoodsListMsg
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutGetTopGoodsListMsg(catId,proxy)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|---|---------|
|
||
| catId | int | 是 | 销量榜类型ID |
|
||
| proxy | string | 否 | 代理地址 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "",
|
||
"data": {
|
||
"status": true,
|
||
"result": {
|
||
"current": 1,
|
||
"data": [
|
||
{
|
||
"author": "吴承恩 著",
|
||
"bookName": "西游记",
|
||
"contentIntroduction": "在中国古代小说中，《西游记（评注本）》是一部思想性和艺术性都臻于第一流的伟大作品。它也是明代长篇小说的重要流派之一神魔小说的代表作，是中国古代神魔小说的翘楚、浪漫文学的代表，作者以其丰富的艺术想象力建构了一个光怪陆离的神话世界，并塑造出以孙悟空、猪八戒为代表的一批性格鲜明、影响深远的文学形象，数百年来一直为人们所喜闻乐见。《西游记（评注本）》主要描写的是孙悟空保唐僧西天取经，历经九九八十一难的故事",
|
||
"imgUrl": "https://booklibimg.kfzimg.com/data/book_lib_img_v2/isbn/1/536c/536c60e36e75bf67f43d790901fc0fe2_0_1_300_300.jpg",
|
||
"isbn": "9787540310097",
|
||
"itemUrls": {
|
||
"appUrl": "kongfz://app.kongfz.com?page=isbnDetail&mid=52528207",
|
||
"mUrl": "https://m.kongfz.com/item/52528207/",
|
||
"miniUrl": "/pages/bookdetail/bookdetail?mid=52528207",
|
||
"pcUrl": "https://item.kongfz.com/book/52528207.html"
|
||
},
|
||
"mid": 52528207,
|
||
"newMinPrice": "3.45",
|
||
"oldMinPrice": "0.20",
|
||
"press": "崇文书局",
|
||
"price": "15.00",
|
||
"pubDate": "2006-05",
|
||
"riseTag": "",
|
||
"authorArr": [
|
||
{
|
||
"name": "吴承恩",
|
||
"oriName": "",
|
||
"nationality": "",
|
||
"role": "著",
|
||
"url": "https://search.kongfz.com/item_result/?status=0&select=2&author=hk5434k627fk6069"
|
||
}
|
||
],
|
||
"pressUrl": "https://search.kongfz.com/item_result/?status=0&press=hk5d07k6587k4e66k5c40"
|
||
}
|
||
],
|
||
"total": 100
|
||
},
|
||
"errMessage": "",
|
||
"errCode": 0
|
||
}
|
||
}
|
||
```
|
||
|
||
## 12.获取配送方式列表--KongfzDeliveryMethodList
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzDeliveryMethodList(appId C.int, appSecret, accessToken *C.char)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|----------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息。 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"requestId": "EGLJzOwutBCR9RDE",
|
||
"requestMethod": "kongfz.delivery.method.list",
|
||
"successResponse": [
|
||
{
|
||
"shippingId": "registerPost",
|
||
"shippingName": "挂号印刷品",
|
||
"isDefault": false,
|
||
"companies": [
|
||
{
|
||
"shippingCom": "registeredPrint",
|
||
"shippingComName": "邮局",
|
||
"isDefault": false
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"shippingId": "express",
|
||
"shippingName": "快递",
|
||
"isDefault": false,
|
||
"companies": [
|
||
{
|
||
"shippingCom": "huitongkuaidi",
|
||
"shippingComName": "百世快递",
|
||
"isDefault": true
|
||
},
|
||
{
|
||
"shippingCom": "yunda",
|
||
"shippingComName": "韵达快递",
|
||
"isDefault": false,
|
||
},
|
||
]
|
||
},
|
||
{
|
||
"shippingId": "generalParcel",
|
||
"shippingName": "普通包裹",
|
||
"isDefault": false,
|
||
"companies": [
|
||
{
|
||
"shippingCom": "generalParcel",
|
||
"shippingComName": "邮局",
|
||
"isDefault": false
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"shippingId": "ems",
|
||
"shippingName": "EMS",
|
||
"isDefault": false,
|
||
"companies": [
|
||
{
|
||
"shippingCom": "ems",
|
||
"shippingComName": "邮局",
|
||
"isDefault": false
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"shippingId": "noLogistics",
|
||
"shippingName": "无需物流",
|
||
"isDefault": false,
|
||
"companies": []
|
||
}
|
||
],
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
## 13.订单发货--KongfzOrderDeliver
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzOrderDeliver(appId, appSecret, accessToken ,
|
||
orderId , shippingId, shippingCom, shipmentNum, userDefined, moreShipmentNum )
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--------|----|-------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| orderId | int | 是 | 订单编号 |
|
||
| shippingId | string | 是 | 配送方式 |
|
||
| shippingCom | string | 否 | 快递公司。当shippingId!=noLogistics时，此参数为必填。取值参考kongfz.delivery.method.list接口的返回值 |
|
||
| shipmentNum | string | 否 | 快递单号。当shippingId!=noLogistics时，此参数为必填。 |
|
||
| userDefined | string | 否 | 用户自定义物流公司。当shippingCom=other时，此参数为必填。 |
|
||
| moreShipmentNum | string | 否 | 填写更多的快递单号，以逗号分隔。 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"requestId": "bbXrGb2dOBRRDRBL",
|
||
"requestMethod": "kongfz.order.deliver",
|
||
"successResponse": {
|
||
"order": {
|
||
"orderId": 73609014,
|
||
"remark": "订单发货成功",
|
||
"updateTime": "2019-05-22 16:32:08"
|
||
}
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
## 14.孔网订单同步--KongfzOrderSynchronization
|
||
### 请求信息
|
||
```gotemplate
|
||
result, err := dll.KongfzOrderSynchronization(appId, appSecret, accessToken, shippingComName,
|
||
orderId, shippingId, shippingCom, shipmentNum, userDefined, moreShipmentNum)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|-----------------------------------------------------------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| shippingComName | string | 是 | 快递名称 |
|
||
| orderId | int | 是 | 订单编号 |
|
||
| shippingId | string | 否 | 配送方式 |
|
||
| shippingCom | string | 否 | 快递公司。当shippingId!=noLogistics时，此参数为必填。取值参考kongfz.delivery.method.list接口的返回值 |
|
||
| shipmentNum | string | 否 | 快递单号。当shippingId!=noLogistics时，此参数为必填。 |
|
||
| userDefined | string | 否 | 用户自定义物流公司。当shippingCom=other时，此参数为必填。 |
|
||
| moreShipmentNum | string | 否 | 填写更多的快递单号，以逗号分隔。 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"requestId": "bbXrGb2dOBRRDRBL",
|
||
"requestMethod": "kongfz.order.deliver",
|
||
"successResponse": {
|
||
"order": {
|
||
"orderId": 73609014,
|
||
"remark": "订单发货成功",
|
||
"updateTime": "2019-05-22 16:32:08"
|
||
}
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
## 15.上传图片接口--KongfzImageUpload
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzImageUpload(appId, appSecret, accessToken, filePath, savePath)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|-------------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| filePath | string | 是 | 图片url/本地图片路径 |
|
||
| savePath | string | 是 | 图片下载路径，如果是图片url需要下载到本地 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"requestId": "bAo3ZN679gaPgR9Y",
|
||
"requestMethod": "kongfz.image.upload",
|
||
"successResponse": {
|
||
"image": {
|
||
"url": "https://www.kfzimg.com/sw/kfzimg/2868/02698c12fec32cc69c_s.jpg" //图片地址
|
||
}
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
## 16.添加店铺商品--KongfzShopItemAdd
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzShopItemAdd(appId, appSecret, accessToken, shopItemAddJson)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|-------------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| shopItemAddJson | string | 是 | 店铺商品请求结构体字符串 |
|
||
#### shopItemAddJson 请求结构体
|
||
添加商品的业务参数比较复杂，根据商品分类的不同，适配不同的模板。以下参数将分别列出模板公共参数和模板特有参数。
|
||
可以查看：https://open.kongfz.com/doc/api/shop/kongfz-shop-item-add
|
||
### 成功响应示例
|
||
```json
|
||
{
|
||
"kongfzShopItemAddResponse": {
|
||
"requestId": "mKPxiCD0dgaPSRib",
|
||
"requestMethod": "kongfz.shop.item.add",
|
||
"successResponse": {
|
||
"item": {
|
||
"itemId": 1343492600, //商品编号
|
||
"addTime": "2019-06-22 16:12:17" //添加时间
|
||
}
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
}
|
||
```
|
||
### 失败响应示例
|
||
```json
|
||
{
|
||
"requestId": "8lDbCNSxzH4UHRx8",
|
||
"requestMethod": "kongfz.shop.item.add",
|
||
"successResponse": null,
|
||
"errorResponse": {
|
||
"code": 3003,
|
||
"msg": "Service error",
|
||
"subCode": "Failed To Add Item",
|
||
"subMsg": "添加商品失败",
|
||
"data": { //字段错误的具体信息会在data中给出，key是出错的字段名，value是错误的原因
|
||
"mouldId": "请先添加运费模板"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 17.查询订单列表--KongfzOrderList
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzOrderList(appId, appSecret, accessToken, orderListJson)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|-------------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| orderListJson | string | 是 | 查询订单请求结构体字符串 |
|
||
#### orderListJson 请求结构体
|
||
```json
|
||
{
|
||
"userType": "String",
|
||
"orderStatus": "String",
|
||
"pageNum": "Integer",
|
||
"pageSize": "Integer",
|
||
"isDelete": "Integer",
|
||
"startDate": "String",
|
||
"endDate": "String",
|
||
"startTime": "String",
|
||
"endTime": "String",
|
||
"startUpdateTime": "String",
|
||
"endUpdateTime": "String"
|
||
}
|
||
```
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"requestId": "VNI5AWvIW5cRLR9l",
|
||
"requestMethod": "kongfz.order.list",
|
||
"successResponse": {
|
||
"total": 5, //总条数
|
||
"pages": 1, //总页数
|
||
"size": 5, //当前页条数
|
||
"pageSize": 20, //每页最大条数
|
||
"pageNum": 1, //当前页码
|
||
"list": [ //订单列表
|
||
{
|
||
"orderId": 25259131, //订单编号
|
||
"createdTime": "2014/06/25 14:36:59", //订单生成时间
|
||
"shopId": 22281, //店铺编号
|
||
"shopName": "俞含的书摊", //店铺名称
|
||
"shopkeeperId": 2522488, //卖家用户编号
|
||
"shipmentNum": "", //快递单号
|
||
"shippingCom": "", //快递公司编码
|
||
"shippingComName": "", //快递公司名称
|
||
"shippingId": "express", //配送方式
|
||
"shippingName": "快递", //配送方式名称
|
||
"shippingFee": "8.00", //快递费
|
||
"goodsAmount": "15.00", //订单商品金额
|
||
"favorableMoney": "0.00", //商品优惠金额
|
||
"orderAmount": "23.00", //订单金额
|
||
"userId": 3723679, //买家用户编号
|
||
"nickname": "买家昵称", //买家昵称
|
||
"receiver": "姓名, 18812345678, 山东省青岛市市北区顺兴路152号404户, 266021", //收件人信息
|
||
"receiverInfo": {
|
||
"area": "24006002000",
|
||
"zipCode": "266021",
|
||
"provName": "山东省",
|
||
"address": "顺兴路152号404户",
|
||
"cityName": "青岛市",
|
||
"areaName": "市北区",
|
||
"receiverName": "姓名",
|
||
"mobile": "18812345678",
|
||
"phoneNum": ""
|
||
},
|
||
"sellerFlagType": 1, //备注类型,孔网是按颜色区分,0是未打标记,1:红,2:黄,3:绿,4:蓝,5:紫
|
||
"sellerRemarkText": "测试备注信息",
|
||
"orderStatus": "SellerCancelledBeforeConfirm", //订单状态
|
||
"orderStatusName": "卖家已取消", //订单状态名称
|
||
"promotionId": 0, //活动编号
|
||
"itemsCount": 1, //订单商品数
|
||
"items": [ //订单商品
|
||
{
|
||
"itemId": 250140272, //商品编号
|
||
"itemSn": "740", //商品货号
|
||
"number": 1, //购买商品数
|
||
"itemName": "玉娇龙 下", //商品名称
|
||
"img": "", //商品图片
|
||
"isCancel": false, //商品是否被取消
|
||
"orderId": 25259131, //订单编号
|
||
"price": "15.00", //商品价格
|
||
"favorableAmount": "0.00", //商品总优惠金额,即:setFavAmount+couponFavAmount,如果购买了多件,为多件商品的总优惠
|
||
"setFavAmount": "0.00", //卖家设置优惠金额,卖家设置的订单优惠均摊到商品上的优惠,如果购买了多件,为多件商品的总优惠
|
||
"couponFavAmount": "0.00", //优惠券优惠金额,订单使用了优惠券时,均摊到商品上的优惠金额,如果购买了多件,为多件商品的总优惠
|
||
"realAmount": "15.00", //商品实付金额, 如果购买了多件，为多件商品的实付总金额
|
||
"cancelMan": "unkown", //取消商品者，unkown：未知，seller：卖家，buyer：买家
|
||
"quality": "", //商品品相
|
||
"isbn": "" //图书ISBN
|
||
}
|
||
]
|
||
},
|
||
]
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
## 18.整合添加商品和获取孔网图片--OutAddGoodsAndFile
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.OutAddGoodsAndFile(token, proxy, filePath, formData)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|---------------------------|
|
||
| token | string | 是 | 孔网token |
|
||
| proxy | string | 是 | 代理服务器IP |
|
||
| filePath | string | 否 | 图片路径 |
|
||
| formData | string | 是 | 商品JSON字符串 |
|
||
### 成功响应示例
|
||
```json
|
||
{
|
||
"data":9395776720,
|
||
"errType":"",
|
||
"message":"",
|
||
"status":1
|
||
}
|
||
```
|
||
|
||
## 查询单个订单--KongfzOrderGet
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.KongfzOrderGet(appId, appSecret, accessToken, userType,orderId)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|----|---------------------------|
|
||
| appId | int | 是 | 开放平台分配给应用的AppId |
|
||
| appSecret | string | 是 | App密钥 |
|
||
| accessToken | string | 否 | 用户登录授权成功后，开放平台颁发给应用的授权信息 |
|
||
| userType | string | 是 | 用户类型。取值 seller: 卖家；buyer: 买家 |
|
||
| orderId | string | 是 | 订单编号 |
|
||
### 成功响应示例
|
||
```json
|
||
{
|
||
"requestId": "GH13BxApG5mRPRl0",
|
||
"requestMethod": "kongfz.order.get",
|
||
"successResponse": {
|
||
"orderId": 73412393, //订单编号
|
||
"createdTime": "2019-05-13 09:31:26", //订单生成时间
|
||
"shopId": 24671, //店铺编号
|
||
"shopName": "网上测试书店（不售书）", //店铺名称
|
||
"shopkeeperId": 3361935, //卖家用户编号
|
||
"shipmentNum": "sa04465846222", //快递单号
|
||
"shippingCom": "registeredPrint", //快递公司编码
|
||
"shippingComName": "挂号印刷品", //快递公司名称
|
||
"shippingId": "registerPost", //配送方式
|
||
"shippingName": "挂号印刷品", //配送方式名称
|
||
"shippingFee": "10.00", //运费
|
||
"goodsAmount": "1.00", //商品金额
|
||
"favorableMoney": "0.00", //订单商品优惠金额
|
||
"orderAmount": "11.00", //订单金额
|
||
"userId": 3361935, //用户编号
|
||
"nickname": "网络测试书店", //用户昵称
|
||
"receiver": "姓名, 18812345678, 山东省青岛市市北区顺兴路152号404户, 266021", //收件人信息
|
||
"receiverInfo": {
|
||
"area": "24006002000",
|
||
"zipCode": "266021",
|
||
"provName": "山东省",
|
||
"address": "顺兴路152号404户",
|
||
"cityName": "青岛市",
|
||
"areaName": "市北区",
|
||
"receiverName": "姓名",
|
||
"mobile": "18812345678",
|
||
"phoneNum": ""
|
||
},
|
||
"sellerFlagType": 1, //备注类型,孔网是按颜色区分,0是未打标记,1:红,2:黄,3:绿,4:蓝,5:紫
|
||
"sellerRemarkText": "测试备注信息",
|
||
"orderStatus": "Shipped-Returning", //订单状态
|
||
"orderStatusName": "申请退货中", //订单状态名称
|
||
"promotionId": 0, //活动编号
|
||
"itemsCount": 1, //订单商品数
|
||
"items": [ //订单商品
|
||
{
|
||
"itemId": 1265078240, //商品编号
|
||
"itemSn": "", //商品货号
|
||
"number": 1, //购买商品数
|
||
"itemName": "测试勿拍19051003", //商品名称
|
||
"img": "//www.kfzimg.com/G07/M00/10/0E/q4YBAFzVOgGAUQvkAAFgEf3-3BU117_s.jpg",//商品图片
|
||
"isCancel": false, //商品是否被取消
|
||
"orderId": 73412393, //订单编号
|
||
"price": "1.00", //商品价格
|
||
"favorableAmount": "0.00", //商品总优惠金额,即:setFavAmount+couponFavAmount,如果购买了多件,为多件商品的总优惠
|
||
"setFavAmount": "0.00", //卖家设置优惠金额,卖家设置的订单优惠均摊到商品上的优惠,如果购买了多件,为多件商品的总优惠
|
||
"couponFavAmount": "0.00", //优惠券优惠金额,订单使用了优惠券时,均摊到商品上的优惠金额,如果购买了多件,为多件商品的总优惠
|
||
"realAmount": "1.00", //商品实付金额, 如果购买了多件，为多件商品的实付总金额
|
||
"cancelMan": "unkown", //取消商品者，unkown：未知，seller：卖家，buyer：买家
|
||
"quality": "六五品", //商品品相
|
||
"isbn": "" //图书ISBN
|
||
},
|
||
],
|
||
"express": [ //物流信息
|
||
{
|
||
"context": "已签收,他人代收：中通快递收,投递员:齐东事:18226889971,"
|
||
"time": "2019-05-20 11:47:38",
|
||
"status": "签收" //状态字段不是都存在，一般只存在于最新的一条记录中
|
||
},
|
||
...
|
||
],
|
||
"records": [ //订单操作记录
|
||
{
|
||
"nickname": "网络测试书店",
|
||
"remark": "买家创建退货协议",
|
||
"time": "2019-05-19 16:38:59",
|
||
"userType": "buyer"
|
||
},
|
||
...
|
||
]
|
||
},
|
||
"errorResponse": null
|
||
}
|
||
```
|
||
|
||
|
||
## 12.初始化--Initialize(可以不调用)
|
||
### 请求信息
|
||
```gotemplate
|
||
result, err := dll.Initialize(configJSON)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|--|----------------|
|
||
| configJSON | string | 是 | 配置信息的 JSON 字符串 |
|
||
### 响应示例
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "初始化成功"
|
||
}
|
||
```
|
||
|
||
## 12.释放C字符串内存--FreeCString
|
||
### 请求信息
|
||
```gotemplate
|
||
dll.FreeCString(str)
|
||
```
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--|--|--|----------|
|
||
| str | string | 是 | 需要释放的字符串 |
|