快速入门

使用说明
海运 API 接口
WEBHOOK 推送
其它

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,宿迁,货物送达门点."
		}],
	"error": []
}
  •