【常见问题】开放API_推送机制（WebHook）相关问题

若有疑问请优先查看平台文件查找。其他非Open API的平台设定问题及卖场问题请直接参考卖家帮助中心。

1.推送机制是什么？要如何设定？

Push机制为推播功能，可以接受到较即时的推播消息，如：订单状态，跟踪号。等，详细设置可参考说明文件。

2.推送机制的延迟问题？

在一小时内返回资讯都是正常的按下时间。

3.多次错误以及非202的状态会影响后续推进吗？

过多的错误将导致系统做出判断故障，将会影响后续提示或暂停按下。

4.有超时的判定时间吗？

虾皮推进后若10秒内无收到2XX的回应，将会判断为推动失败。

5.按下失败后需要等待多久虾皮才会尝试尝试？

第一次尝试失败，将会再30分钟后重新重启；过多失败将会暂停服务，请参考第三点和第六点。

6.收到终止通知信原因？

过去6小时，开发者提供的回调url有过多错误，将暂停继续推进，请自行检查提供的url是否有其他问题存在；若需重启请重设回调url并进行验证。

7.可否提供shopee推送的格式？

请参考文件说明：代码定义

 Shopee官网原文详情：

【FAQ】Open API_Push Mechanism(WebHook)相關問題

若有疑問請優先查看平台文件查找。其他非Open API的平台設定問題及賣場問題請直接參考賣家幫助中心。

1.Push Mechanism是什麼?要如何設定?

Push Mechanism為推播功能，可以接受到較即時的推播訊息，如：訂單狀態、Tracking no..等，詳細設定可參考說明文件。

2.Push Mechanism的延時問題?

在一小時內返回資訊都是正常的推送時間。

3.多次錯誤以及非202的狀態會影響後續推送嗎?

過多錯誤將導致系統判定推送故障，將會影響後續推送或暫停推送。

4.有Timeout的判定時間嗎?

蝦皮推送後若10秒內無收到2XX的回應，將會判斷為推送失敗。

5.推送失敗後需要等待多久蝦皮才會嘗試推送?

第一次推送失敗，將會再30分鐘後重新推送；過多失敗將會暫停推送服務，請參考第三點和第六點。

6.收到停用通知信原因?

過去6小時，開發者提供的call back url有過多錯誤，將暫停繼續推送，請自行檢查提供的url是否有其他問題存在；若需重啟請重設call back url並verify。

7.可否提供shopee推送的格式?

請參考文件說明：Code Definition

 文章来源：Shopee官方网站  

（本文内容根据网络资料整理和来自用户投稿，出于传递更多信息之目的，不代表本站其观点和立场。本站不具备任何原创保护和所有权，也不对其真实性、可靠性承担任何法律责任，特此声明！）

常见问答(FQAS)

WebHook机制是指第三方应用程序可以注册一个URL地址到Shopee平台,Shopee平台会按照用户应用程序定义的事件将有关信息以JSON格式POST到该地址,实现推送机制。

开发者需要登录Shopee后台,在\"开放API\"菜单下选择\"WebHook\"项,输入URL地址并选择要推送的事件类型,完成注册并保存即可。

WebHook地址必须是一个可公开访问的URL,支持HTTP和HTTPS协议,域名可以是IP地址或是子域名,但不支持内网IP。WebHook地址必须能正常响应POST请求。

WebHook消息会在事件触发后的短时间内被异步调用,一般情况下响应时间在1秒内,极端情况可能需要几秒。正常情况下,1小时内调用次数不超过1000次。

应用程序接收到WebHook调用后需要正确响应,返回HTTP状态码200即可。其他状态码会导致重复调用。如果处理失败,可以从响应头中取得请求ID帮助排查问题。