跳到主要内容

创建预上网轨迹

为指定的尾派小包创建预上网追踪轨迹。

端点： POST /api/shipments/{id}/partner-events

所需权限 (Scope): shipments:write

路径参数​

参数类型必填描述
idstring是用于创建轨迹的尾派小包 ID。

请求规范​

属性类型必填描述
EventsShipmentPartnerEvent[]是待为该尾派小包创建的预上网轨迹列表。

响应规范​

返回包装在 Result 中的空数据。

示例 JSON​

请求​

{
  "Events": [
    {
      "EventCode": "PICKEDUP",
      "EventTime": "2026-06-15T20:55:00-07:00",
      "Location": {
        "PostCode": "90001",
        "CountryCode": "US"
      }
    },
    {
      "EventCode": "ARRIVED",
      "EventTime": "2026-06-15T21:00:00-07:00",
      "Location": {
        "PostCode": "90001",
        "CountryCode": "US"
      }
    },
    {
      "EventCode": "DEPARTED",
      "EventTime": "2026-06-15T22:00:00-07:00",
      "Location": {
        "PostCode": "90001",
        "CountryCode": "US"
      }
    }
  ]
}

响应​

{
  "Succeeded": true,
  "Error": null,
  "CapturedValues": {}
}