【代码开源】GreaterWMS 抖音SDK调用教程

应用介绍

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 = ""
        self.param.out_product_id = ""
        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": "",
    "car_vin_code": "VIN",
    "category_detail": {
      "first_cid": "",
      "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": "",
    "discount_price": "",
    "draft_status": "2",
    "extra": "-",
    "img": "https://xxxx.byted.org/obj/temai/54cbfeff94ac0af5bf5c2960www800-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": "",
    "maximum_per_order": "5",
    "minimum_per_order": "1",
    "mobile": "",
    "name": "xxx爽肤水",
    "need_recharge_mode": "false",
    "open_user_id": "1",
    "out_product_id": "",
    "outer_product_id": "",
    "pay_type": "1",
    "pic": "[\"https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0db1aab41www800-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\":\"\",\"PropertyId\":1618,\"PropertyName\":\"ISBN编号\",\"diy_type\":0}],\"1831\":[{\"Value\":0,\"Name\":\"小学英语看图说话写话二年级\",\"PropertyId\":1831,\"PropertyName\":\"书名\",\"diy_type\":0}],\"2000\":[{\"Value\":,\"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": "",
    "product_id_str": "",
    "quality_list": [
      {
        "quality_attachments": [
          {
            "media_type": "1",
            "url": "http://www.byted***.com/YYYY"
          }
        ],
        "quality_key": "3457***",
        "quality_name": "进货凭证"
      }
    ],
    "recommend_remark": "真的很好啊",
    "spec_id": "1",
    "spec_pics": [
      {
        "pic": "temai/bc50b994f4c89de56acaca5d6569awww800-800",
        "spec_detail_id": ""
      }
    ],
    "spec_prices": [
      {
        "code": "aaa",
        "customs_report_info": {
          "bar_code": "-",
          "first_measure_qty": "1",
          "first_measure_unit": "-",
          "g_model": "-",
          "hs_code": "",
          "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": "",
        "sku_type": "0",
        "spec_detail_id1": "",
        "spec_detail_id2": "",
        "spec_detail_id3": "0",
        "spec_detail_ids": "[, ]",
        "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": "",
        "is_leaf": "0",
        "name": "颜色",
        "pid": "",
        "spec_id": "",
        "values": [
          {
            "id": "",
            "is_leaf": "1",
            "name": "红色",
            "pid": "",
            "spec_id": "",
            "status": "1"
          }
        ]
      }
    ],
    "standard_brand_id": "",
    "status": "1",
    "update_time": "2021-03-29T15:52:52+08:00"
  },
  "err_no": 0,
  "message": "success",
  "code": ,
  "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


技术交流群

专注于为中小企业提供成都做网站、成都网站设计服务,电脑端+手机端+微信端的三站合一,更高效的管理,为中小企业荣成免费做网站提供优质的服务。我们立足成都,凝聚了一批互联网行业人才,有力地推动了上千家企业的稳健成长,帮助中小企业通过网站建设实现规模扩充和转变。





网站名称:【代码开源】GreaterWMS 抖音SDK调用教程
文章分享:http://scyanting.com/article/dsoghio.html