Loader4D API

您可以做什么

端点

身份验证使用携带您密钥的 bearer 请求头。密钥从不接受写在查询字符串中。

Authorization: Bearer l4d_live_...

调用	作用
POST /api/v1/pack	开启一个摆放作业；返回 202 和一个作业编号。
GET /api/v1/jobs/{id}	返回作业状态，完成后返回其结果。
GET /api/v1/usage	返回本周期配额和剩余额度。

请求示例

长度单位是厘米，重量单位是千克。没有按请求设置单位的选项；请在您这一侧完成换算。以英寸发送的请求会装载一辆长十倍的卡车。

POST /api/v1/pack
Authorization: Bearer l4d_test_...
Content-Type: application/json
Idempotency-Key: 7f3c1a9e4b6d4c2f

{
  "reference": "SO-2026-4417",
  "spaces": [
    { "id": "sp1", "name": "40HC", "type": "container",
      "length": 1200, "width": 235, "height": 269,
      "max_weight": 26000, "available": 2 }
  ],
  "items": [
    { "id": "A1", "name": "Karton", "length": 120, "width": 100, "height": 40,
      "weight": 8, "quantity": 24, "group": "Siparis-1",
      "constraints": { "no_tilt": true } },
    { "id": "B1", "name": "Varil", "shape": "cylinder",
      "diameter": 58, "length": 88, "weight": 190, "quantity": 12,
      "constraints": { "floor_only": true } }
  ],
  "strategy": { "group_items": true, "balance_load": true }
}

响应立即返回；您通过轮询作业编号获取结果。

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/ba7189d3b1824da3806ca3ee973b2294

{ "id": "ba7189d3...", "status": "queued", "progress": 0,
  "reference": "SO-2026-4417", "credits": 1 }

作业完成后，每件货物都会带着坐标返回。原点是装载空间的前左下角，给出的值是货物的该角，而非其中心。

{ "id": "ba7189d3...", "status": "succeeded", "credits": 1,
  "result": {
    "summary": { "spaces_used": 1, "pieces_requested": 36,
                 "pieces_packed": 36, "weight": 2472,
                 "volume_utilization": 0.7431 },
    "spaces": [
      { "space_id": "sp1", "name": "40HC",
        "placements": [
          { "item_id": "A1", "sequence": 1,
            "x": 0, "y": 0, "z": 0,
            "length": 120, "width": 100, "height": 40, "weight": 8 }
        ],
        "axle_loads": [] }
    ],
    "unpacked": []
  } }

字段与约束的完整列表、错误码以及 OpenAPI 文档，请查看 API 参考

额度与限制

额度在作业被接受时扣除，而非完成时。否则同时到达的一百个调用会在任何一个被计数之前全部通过配额检查。

请求中的货物总件数	额度
1 – 100	1
101 – 1 000	5
1 001 – 10 000	25
10 001 及以上	100

• 每个请求最多 50 个装载空间。
• 每个请求最多 2 000 行货物。
• 每个请求总计最多 20 000 件货物。
• 每个团队最多 10 个有效密钥。

这些限制的存在是为了让单次调用无法长时间占用服务。如果您的工作量需要更多，请拆分或与我们联系。

常见问题