WEBHOOK 推送

Webhook概述

一、概述:

  • Webhook 是一种通过自定义回调来更改 Web 应用程序的方法。
  • 通过 Webhook,可以主动触发数据更新,确保信息的及时性。每次触发请求,Webhook 都会通过您配置的 URL 将数据响应给您。

如何设置Webhook

您可以在用户后台,轻易找到webhook 栏目,并设置、启用、停用 webhook。我们目前仅支持 HTTP 或 HTTPS协议的网络通信。在使用webhook时,需要您的端点在互联网上可访问并完全开放。

Webhook示例

了解TOOLSTIP webhook请求过程。

一、发起请求:

  • 接受端必须允许以HTTP或HTTPS协议通过POST形式发起请求。
  •  
  • 1. 请求头
  • 表头中 Content-Type 对应值必须为 application/json,Content-Type 默认提供 UTF-8 格式的字符集参数,其他编码格式都不支持。
  •  
  • Accept: */*
    Content-Type: application/json
    Connection: keep-alive
  •  

二、请求报文示例

  •  
  • {
    	"meta": {
    		"code": 200,
    		"type": "Success",
    		"message": "获取数据成功"
    	},
    	"data": [{
    		"route": [{
    			"shipName": "长恒26",
    			"voyage": "2238S",
    			"counts": "2",
    			"POL": "天津",
    			"POD": "上海",
    			"ETD": "2022-08-28",
    			"ATD": "2022-08-28",
    			"ETA": "2022-08-30",
    			"ATA": "2022-08-30"
    		}, {
    			"shipName": "华海祥",
    			"voyage": "J22043",
    			"counts": "2",
    			"POL": "上海",
    			"POD": "宿迁",
    			"ETD": "2022-09-08",
    			"ATD": "2022-09-08",
    			"ETA": "2022-09-11",
    			"ATA": "2022-09-11"
    		}],
    		"origin": "天津",
    		"destination": "宿迁",
    		"detail": [{
    			"ctnumber": "RAWU8047858",
    			"size": "40HQ",
    			"weight": "",
    			"info": [{
    				"date": "2022-09-16 10:27",
    				"local": "宿迁",
    				"event": "货物送达门点."
    			}, {
    				"date": "2022-08-23 05:26",
    				"local": "天津",
    				"event": "集装箱在港口【天津】 出闸"
    			}],
    			"status": 2,
    			"last": "2022-09-16 10:27,宿迁,货物送达门点."
    		}, {
    			"ctnumber": "RAWU8049017",
    			"size": "40HQ",
    			"weight": "",
    			"info": [{
    				"date": "2022-09-16 10:26",
    				"local": "宿迁",
    				"event": "货物送达门点."
    			}, {
    				"date": "2022-08-23 14:57",
    				"local": "天津",
    				"event": "您提交了订舱单,请等待系统确认"
    			}, {
    				"date": "2022-08-23 06:22",
    				"local": "天津",
    				"event": "集装箱在港口【天津】 出闸"
    			}],
    			"status": 2,
    			"last": "2022-09-16 10:26,宿迁,货物 送达门点."
    		}],
    		"status": "In Transit",
    		"name": "安通物流  ",
    		"nameEn": "An Tong WuLiu",
    		"shipName": "antong56",
    		"number": "ATIASUQ220475608",
    		"updateAt": "2024-08-27 22:29:37"
    	}],
    	"error": []
    }
  •