图片展示

成 都 狮 龙 书 廊 科 技 有 限 责 任 公 司

Chengdu Shilong Pearson Education technology  Limited  Liability  Technology Group Co., Ltd.

头条号网站验证文件

好啊,"搜 "

 

好啊,"搜 "

 

客服电话:13904310313   

 

公司总机:028-67876373              

 

钉钉客服:17684321066                   

 

备案电话:15680712313 

 

商标注册服务电话:15210354365  

 

消息推送服务接入指南

狮龙书廊 青云科技

消息推送服务接入指南

100

产品参数

  • 标准设计 1
  • 产品外观 1
  • 文本模块 1
  • 文件标准 1
展开全部 收起

产品详情

消息推送服务接入指南

更新时间:2022-09-13 20:54:57访问次数:3501

概述

为提高开发者API接口调用效率,增强数据通信的实时性,抖店开放平台提供主动推送消息服务。基于消息推送服务,只要相关事件发生,就会把对应的消息实时推送到开发者配置的推送地址。 开发者无需通过轮询API来获取店铺数据,仅需在接收到消息后解析即可。使用该种数据对接方式可以大大提高API调用效率,减少双方计算资源的浪费。
目前,抖店开放平台支持订单消息、退款消息以及商品消息的推送,后续更多的消息类型将持续开放订阅。例如物流消息、客服消息等。需要注意的是,若涉及中文字符,必须进行UTF-8转换处理。

一、消息推送链路

当业务场景满足某个消息触发的条件时,抖店开放平台会从业务中台收到该消息,对消息进行处理后,会将消息分发给满足条件的应用。
这些应用必须满足以下条件:

  • 消息中的店铺和应用有授权关系且授权状态是生效的
  • 应用订阅了该类型消息事件


二、如何使用消息推送服务

1、登录抖店开放平台,进入控制台-应用后台

  • 请确保选择正确的应用,检查app_key,避免误推送消息给其他应用
  • 请确保应用中已授权的店铺,是需要推送信息给应用的店铺


2、进入配置消息推送地址

  • 推送地址是开发者用来接收消息的地址,目前仅支持配置一个地址
  • 地址需公网可访问(测试选择和服务器不同域的一台电脑,在chrome浏览器右键【检查】,查看Network中的Status是否是200,如果出现非200状态请检查自己的网址)
  • 推送地址添加后,平台会立即Post一条"[{"tag":"0","msg_id":"0","data":"2020-09-10T16:27:56.52842897+08:00"}]"的测试消息,必须返回{"code":0,"msg":"success"} ,否则平台判定推送地址异常,将无法启用消息推送服务

3、按需订阅具体消息

页面上列出来所有已支持的消息事件,开发者可以按需要订阅。详见 消息文档

4、开启消息推送服务

  • 开启服务开关,消息才会正常推送
  • 关闭服务开关,消息停止推送

5、消息解析

开发者在消息推送地址指向的本地服务中,通过解析请求头和消息体,可以获取每条消息的具体信息。

i)请求头字段:

消息请求头中的字段参数类型参数描述
event-signString防伪签名,可通过该字段值判断消息是否伪造 签名生成算法
app-idString对应开发者后台的app_key

MD5加密demo

func GenMsgSign(c *gin.Context) { 
body,_ := ioutil.ReadAll(c.Request.Body) 
signParam := "yourAppId" + string(body) + "yourSecret" 
sign := md5(signParam) // 生成md5 
/** 
... 
 */ 
}

MD5加密前的demo:

yourId[{"tag":"xxx","msg_id":"xxxxxx","data":"{\"p_id\":123,\"s_ids\":[123],\"shop_id\":123456,\"status\":5,\"order_status\":5,\"order_type\":0,\"complete_time\":1616410797,\"biz\":2}"}]yourSecret

hmac加密demo:

signParam(同demo) = "yourAppId[{"tag":"xxx","msg_id":"xxxxxx","data":"{\"p_id\":123,\"s_ids\":[123],\"shop_id\":123456,\"status\":5,\"order_status\":5,\"order_type\":0,\"complete_time\":1616410797,\"biz\":2}"}]yourSecret"
secret = yourSecret
func genHmacSHA256String(secret, signParam string) string {
h := hmac.New(sha256.New, []byte(secret))
_, _ = h.Write([]byte(signParam))
return hex.EncodeToString(h.Sum(nil))
}

ii)消息体示例:

我们给推送地址推送的消息体是 一个list,list中包含多个对象,开发者可以直接从RequestBody中获取消息体。

[ 
{"tag":"100","msg_id":"31234597708719700740100000000000015985838476838502441600763400","data":"{\"p_id\":4712345680779753833,\"s_ids\":[4712345680779753833],\"shop_id\":3123451,\"order_status\":0,\"order_type\":0,\"create_time\":1598583234,\"biz\":2}"}, 
{"tag":"101","msg_id":"31234597708719700740100000000000015234234236838502441600763411","data":"{\"p_id\":4712345680779753833,\"s_ids\":[4712345680779753833],\"shop_id\":3123451,\"order_status\":0,\"order_type\":0,\"create_time\":1598583234,\"biz\":2}"} 
]

iii)消息体list对象中的参数释义:

消息体list对象中的参数名称参数类型参数描述
tagString消息种类
msg_idString消息唯一标示id。消息存在重推或重复发送的可能,请开发者做好幂等处理。当前字符串长度是68位,该字段长度存在增加的可能性,建议做好长度兼容,以防止处理异常,建议预留长度100个字符串。
dataStruct消息体具体数据,详见 消息文档

iiii)返回接收成功标识

  • 接收到消息后,需要返回{"code":0,"msg":"success"}。否则,推送服务将认为该条消息没有推送成功,会开启自动重推(注意:超时也会被认为是推送失败,超时时间是2s)
  • code不能传负数

6、推送规则

  • 消息推送服务通过POST、参数编码为APPLICATION/JSON(输入流)的方式向开发者提供的地址推送消息。由于平台服务端响应超时时间为2s,建议开发者接收到消息后立即返回成功code,再异步去处理自有的业务信息
  • 开发者接收到消息后必须返回 {"code":0,"msg":"success"} 通知抖店开放平台成功接收,否则会被判定为推送失败,系统会自动进行消息重推。最多重推3次,推送的时间间隔分别为30s、5min、1h。比如,一条新的消息推送失败了,第二次推送将会在30s后触发,以此类推
  • 一次消息推送请求,消息体list最多含50个消息事件
  • 如下图,开发者可以在【控制台-应用后台-消息推送-推送记录】页面看到推送记录及详情;推送失败的记录,支持手动重推

Tips:
1、消息推送记录只保存近7天的数据,7天以前的消息无法查询到,也无法重新推送;
2、消息可能出现偶发无序,对于可能存在资损的地方需要开发者反查订单接口;



消息推送服务接入指南
消息推送服务接入指南
长按识别二维码查看详情
长按图片保存/分享
询盘

在线询盘 更多+
  • 联系人 *

  • 手机 *

  • 描述

  • 提交

  • 验证码
    看不清?换一张
    取消
    确定

咨询内容:


你还没有添加任何产品

图片展示
文件标题
文件大小
下载次数
更新时间

成都狮龙书廊科技有限责任公司,是一家互联网高科技技术研究开发企业,本公司不以销售产品为目的,以展示公司文化为主。登记注册在四川成都高新区,企业纳税人识别号:91510100MA62N9D027,公司经营主业以计算机软件代码和硬件技术设计,电子产品和提供技术服务;软件开发;网页设计;图文设计;美术图案设计;网络技术服务;和商务咨询,代理制作发布各类广告推广业务,企业简称狮龙书廊科技,艺画斋----国际商业美术师,毛凌国.中国 互联网应用展示平台,是当代科技前沿领域开展艺术引领创新的云空间,在这里,本着帮助现有科技企业,开发设计领域,学术指导领域,新的创新,发明实用新型,和外观设计的展示平台,有机会聚集青年一代设计师,艺术设计者,学者和文化传承人的学术应用展示,普及传统美学思想与中外文化白花映演,实现中国梦,凝聚中国民族团结的社会价值。

狮龍畫廊---品牌是邦企科技认证的品牌项目,(狮龙书廊)企业实名认证的信用,科技驱动人文艺术和文明,推动中国文化传承事业在一带一路建设中的积极作用,我们不仅仅是企业,也是国际商业美术事业发展的推动者,高科技应用的转化和开发前沿领跑者,是未来职业发展的标准贯彻执行推广实体,是追求目标的技术型推广基石。成都狮龙书廊科技有限责任公司,服务社会的类型是以企业模式经营,独立的法人负责制体系,对社会组织和个体包括公司,开展各类的服务项目,如网络技术服务,建站设计,代理域名,空间结构分布云技术,微周微信开发和技术产品推广,特别是国际高科技人才服务和认证服务领域的经验的分享服务。成都狮龙书廊科技有限责任公司入围中国数字产业企业诚信企业,狮龙书廊通过中国电子人证服务产业联盟认证,具有较高服务和任用等级。艺画斋企业服务的一个项目。 

国际商业美术设计师(International Commercial Art Designer英文缩写ICAD)职业资格认证是国际商业美术设计师协会(International Commercial Art Designer Association,英文缩写ICADA)在全球范围内推行的四级商业美术设计专业资质认证体系的总称。它是以国际职业标准为导向,以实际工作能力、经验、知识和艺术素养为考评依据的一种新型的职业资格证书制度。  

 

 
CONTACT US

点击链接加入我的企业“成都狮龙廊科技有限责任公司长春分公司”,一起开启全新办公体验吧。 https://work.weixin.qq.com/join/w-A6Tt1b7iLuLRUM_ChDDg/hb_share_qymng_mjoin?is=203

 

电话总机:028-67873673

分机:

 

 

地址:成都高新区府城大道399号7栋2单元14层1404号

成都狮龙书廊科技有限责任公司 毛凌国 业务电话:17684321066神马搜索推广品牌竞价排名

<--------阿里地图开发代码-将代码嵌入到论坛、博客、网站中:------>

 

公共邮箱:public@maolg.com

企业管理员:admin@maolg.com

网站管理:webmaster@maolg.com

企业邮箱:mail.maolg.com

 

 

 

中国区官网:  www.maolg.com

成都总公司:   www.maolg.net

狮龙书廊长春分公司:www.maolg.cn

毛凌国我爱你: www.毛凌国.我爱你

 

联系我们

成都狮龙书廊科技有限责任公司

 

Chengdu high tech Zone Fucheng  Road  No.399 

Building  7  2  unit  14 floor  No.1404

    邮编(Zip Code):610000   

总机(搜狗认证电话): 028-67876373   

服务器虚拟备案空间服务商 北京息壤科技信息   

机房电话(TEL):0431-85769416

网址(Website)://www.maolg.com   

企业邮箱传真:4008266163-81212 

 

成都狮龙书廊科技有限责任公司长春分公司

统一社会信用代码91220101MA14BJJ05D

开户银行名称:中国银行股份有限公司长春汽车厂支行    开户银行代码:104241010003 

开户名称:成都狮龙书廊科技有限责任公司长春分公司    企业账号:163642934965 

地址:长春汽车经济技术开发区一汽集团公司二生活区610栋2单元504号房

 开户银行代码:104241010003

电子邮箱(Email): public@maolg.com 推广链接

网络管理员(administrator): admin@maolg.com     

 

  ICP备案/许可证编号:吉 ICP备14006459号-3

Copyright © 2016-2022 All Rights Reserved  

Chengdu  Shilong  Pearson  Education  Science  and technology  limited liability  company   

企业微信

 

企业微信 企业微信

狮龙书廊品牌创造价值,创造财富帝国!你还在等什么?

添加微信好友,详细了解产品
使用企业微信
“扫一扫”加入群聊
复制成功
添加微信好友,详细了解产品
我知道了
吉ICP备14006459号-3