应用介绍
GreaterWMS 抖音SDK调用教程
SDK具体功能:
- 1,一仓多店,多仓多店
- 2,库存同步,商品同步
- 3,快递发货,物流轨迹
- 4,订单拦截
- 5,字节云仓
- 6,精选联盟
- 7,供应分销
- 8,售后退款,账单
对应的API链接
- 抖音API文档
- 抖音消息推送文档
创建抖店
- 去抖音官方创建个商家应用
- 抖店应用会给到3个Key,APPID,APP_SECRET,SHOP_ID
- 在GreaterWMS电商店铺中,抖音页面添加一个店铺
- 填入之前获得的3个Key和店铺名称
- GreaterWMS会给这个店铺生成一个唯一值,用来实现一仓多店的唯一性
沙箱环境开启
- 沙箱环境为了安全起见,并不能通过前端去修改,以免用户误点
- 向以下路径post一个json data
- http://127.0.0.1:8008/shopid/douyin/sandbox/
{
\"t_code\": \"{ 你刚才在GreaterWMS会给这个店铺生成一个唯一值 }\",
\"sandbox\": \"{ 将sandbox调整成开启还是关闭,开始是1,关闭是0 }\"
}
- 由此来控制店铺是否正式运营上线,默认是正式环境
代理IP开启
- 代理IP为了安全起见,并不能通过前端去修改,以免用户误点
- 向以下路径post一个json data
- http://127.0.0.1:8008/shopid/douyin/proxy/
{
\"t_code\": \"{ 你刚才在GreaterWMS会给这个店铺生成一个唯一值 }\",
\"proxy\": \"{ 将代理调整成开启还是关闭,开始是1,关闭是0 }\",
\"proxy_ip\": \"{ 代理ip,是一个json数据 }\"
}
- 代理设置,None或者{\"https\": \"http://10.10.1.10:1080\"},详细格式参见https://docs.python-requests.org/zh_CN/latest/user/advanced.html
- 由此来控制店铺是否正式使用代理,默认是不使用
安装
- 下载插件
- https://community.56yhz.com/plugMarket/118.html
- 放到GreaterWMS根目录下面
pip install GreaterWMS_DouYin-1.0.0-py3-none-any.whl
- 版本的更新,安装的插件名会不同,请自行调整版本
- 注册app
INSTALLED_APPS = [
\'...\',
\'...\',
\'douyin\'
]
API调用例子
# 在views.py
from douyin.views.ding_dan.order_searchList import OrderSearchList
class Test(OrderSearchList):
def __init__(self):
self.params = {}
self.param.product_id = \"3539925204033339668\"
self.param.out_product_id = \"11111\"
self.param.show_draft = \"true\"
# urls.py
from django.urls import path
from .views import Test
urlpatterns = [
path(r\'test/\', Test.as_view({\"post\": \"create\"}), name=\"test\")
]
- 接下来只要向这个接口POST一个之前提到的店铺唯一值,\"t_code\" 就可以获取数据
回调的示例
{
\"data\": {
\"account_template_id\": \"1\",
\"after_sale_service\": \"{\\\"supply_7day_return\\\":\\\"2\\\"}\",
\"appoint_delivery_day\": \"2\",
\"brand_id\": \"12344\",
\"car_vin_code\": \"VIN11111111111111\",
\"category_detail\": {
\"first_cid\": \"23264\",
\"first_cname\": \"教育培训\",
\"fourth_cid\": \"0\",
\"fourth_cname\": \"-\",
\"second_cid\": \"0\",
\"second_cname\": \"学习卡\",
\"third_cid\": \"0\",
\"third_cname\": \"-\"
},
\"cdf_category\": \"1\",
\"check_status\": \"1\",
\"create_time\": \"2021-03-29 15:52:52\",
\"delivery_delay_day\": \"2\",
\"delivery_method\": \"7\",
\"description\": \"<img src=\\\\\\\"https://tosv.boe.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800\\\\\\\" style=\\\\\\\"width:100%;\\\\\\\">\",
\"discount_price\": \"12000\",
\"draft_status\": \"2\",
\"extra\": \"-\",
\"img\": \"https://xxxx.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800\",
\"is_create\": \"1\",
\"is_sub_product\": \"true\",
\"limit_per_buyer\": \"5\",
\"logistics_info\": {
\"brand_country_id\": \"123\",
\"customs_clear_type\": \"1\",
\"net_weight_qty\": \"100\",
\"origin_country_id\": \"123\",
\"source_country_id\": \"123\",
\"tax_payer\": \"0\"
},
\"market_price\": \"12000\",
\"maximum_per_order\": \"5\",
\"minimum_per_order\": \"1\",
\"mobile\": \"15677775555\",
\"name\": \"xxx爽肤水\",
\"need_recharge_mode\": \"false\",
\"open_user_id\": \"1\",
\"out_product_id\": \"11111\",
\"outer_product_id\": \"11111\",
\"pay_type\": \"1\",
\"pic\": \"[\\\"https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\\\"]\",
\"poi_resource\": {
\"coupon_return_methods\": \"[1]\"
},
\"presell_config_level\": \"2\",
\"presell_delay\": \"4\",
\"presell_type\": \"1\",
\"price_has_tax\": \"0\",
\"product_format\": \"{\\\"货号\\\":\\\"8888\\\"}\",
\"product_format_new\": \"{\\\"1088\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"小33学二年级\\\",\\\"PropertyId\\\":1088,\\\"PropertyName\\\":\\\"适用学龄段\\\",\\\"diy_type\\\":1}],\\\"1319\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"1\\\",\\\"PropertyId\\\":1319,\\\"PropertyName\\\":\\\"适用地区\\\",\\\"diy_type\\\":0}],\\\"1618\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"9787218122861\\\",\\\"PropertyId\\\":1618,\\\"PropertyName\\\":\\\"ISBN编号\\\",\\\"diy_type\\\":0}],\\\"1831\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"小学英语看图说话写话二年级\\\",\\\"PropertyId\\\":1831,\\\"PropertyName\\\":\\\"书名\\\",\\\"diy_type\\\":0}],\\\"2000\\\":[{\\\"Value\\\":34762,\\\"Name\\\":\\\"无\\\",\\\"PropertyId\\\":2000,\\\"PropertyName\\\":\\\"作者地区\\\",\\\"diy_type\\\":0}],\\\"2229\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"1\\\",\\\"PropertyId\\\":2229,\\\"PropertyName\\\":\\\"编者\\\",\\\"diy_type\\\":0}],\\\"3271\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"1\\\",\\\"PropertyId\\\":3271,\\\"PropertyName\\\":\\\"出版时间\\\",\\\"diy_type\\\":0}],\\\"449\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"1\\\",\\\"PropertyId\\\":449,\\\"PropertyName\\\":\\\"作者\\\",\\\"diy_type\\\":0}],\\\"501\\\":[{\\\"Value\\\":7310,\\\"Name\\\":\\\"否\\\",\\\"PropertyId\\\":501,\\\"PropertyName\\\":\\\"是否是套装\\\",\\\"diy_type\\\":0}],\\\"855\\\":[{\\\"Value\\\":0,\\\"Name\\\":\\\"陕西人民教育出版社\\\",\\\"PropertyId\\\":855,\\\"PropertyName\\\":\\\"出版社名称\\\",\\\"diy_type\\\":0}]}\",
\"product_id\": \"3539925204033339668\",
\"product_id_str\": \"3539925204033339668\",
\"quality_list\": [
{
\"quality_attachments\": [
{
\"media_type\": \"1\",
\"url\": \"http://www.byted***.com/YYYY\"
}
],
\"quality_key\": \"3457***9470978\",
\"quality_name\": \"进货凭证\"
}
],
\"recommend_remark\": \"真的很好啊\",
\"spec_id\": \"1\",
\"spec_pics\": [
{
\"pic\": \"temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800\",
\"spec_detail_id\": \"1695459998447656\"
}
],
\"spec_prices\": [
{
\"code\": \"aaa\",
\"customs_report_info\": {
\"bar_code\": \"-\",
\"first_measure_qty\": \"1\",
\"first_measure_unit\": \"-\",
\"g_model\": \"-\",
\"hs_code\": \"1564564\",
\"report_brand_name\": \"-\",
\"report_name\": \"-\",
\"second_measure_qty\": \"1\",
\"second_measure_unit\": \"-\",
\"unit\": \"-\",
\"usage\": \"-\"
},
\"lock_step_stock_num\": \"1\",
\"lock_stock_num\": \"1\",
\"out_sku_id\": \"0\",
\"outer_sku_id\": \"0\",
\"presell_delay\": \"5\",
\"price\": \"102\",
\"prom_step_stock_num\": \"0\",
\"prom_stock_num\": \"0\",
\"promotion_step_stock_num\": \"0\",
\"promotion_stock_num\": \"0\",
\"sku_id\": \"1695459998495774\",
\"sku_type\": \"0\",
\"spec_detail_id1\": \"1695459998494734\",
\"spec_detail_id2\": \"1695459998494734\",
\"spec_detail_id3\": \"0\",
\"spec_detail_ids\": \"[1695459998494734, 1695459998494766]\",
\"step_stock_num\": \"0\",
\"stock_num\": \"13\",
\"stock_num_map\": {},
\"supplier_id\": \"123\",
\"tax_exemption_sku_info\": {
\"is_suit\": \"1\",
\"suit_num\": \"10\",
\"volume\": \"100\"
}
}
],
\"specs\": [
{
\"id\": \"1713023986705415\",
\"is_leaf\": \"0\",
\"name\": \"颜色\",
\"pid\": \"1713023986705415\",
\"spec_id\": \"1713023983665214\",
\"values\": [
{
\"id\": \"1695459998447656\",
\"is_leaf\": \"1\",
\"name\": \"红色\",
\"pid\": \"1695459998447640\",
\"spec_id\": \"1713023983665214\",
\"status\": \"1\"
}
]
}
],
\"standard_brand_id\": \"121354\",
\"status\": \"1\",
\"update_time\": \"2021-03-29T15:52:52+08:00\"
},
\"err_no\": 0,
\"message\": \"success\",
\"code\": 10000,
\"msg\": \"success\",
\"sub_code\": \"\",
\"sub_msg\": \"\"
}
- 一定要POST店铺唯一值,这样系统才会判断是哪个店铺发起的请求
消息推送
# 在views.py
from douyin.views.notify import NotifyAPI
class Notify(NotifyAPI):
def __init__(self):
self.params = {}
# urls.py
from django.urls import path
from .views import Notify
urlpatterns = [
path(r\'notify/\', Notify.as_view({\"post\": \"create\"}), name=\"notify\")
]
- 接下来只要向这个接口POST一个之前提到的店铺唯一值,\"t_code\" 就可以获取数据
- 一定要POST店铺唯一值,这样系统才会判断是哪个店铺发起的请求
功能
下载地址
https://community.56yhz.com/plugMarket/118.html
技术交流群
来源:https://www.cnblogs.com/elaineZ/p/16081170.html
本站部分图文来源于网络,如有侵权请联系删除。