DHL Paket DE Versenden API 2.1.1：printFormat参数传递位置咨询

针对你遇到的printFormat参数传递位置错误、默认配置不生效的问题，直接给你可行的解决方案：

• 正确传递位置：URL查询参数
  DHL Paket DE Versenden API 2.1.1版本中，printFormat参数需要作为URL查询参数附加在请求地址后，而非请求头或POST的JSON请求体里。比如创建运单的请求URL应该写成：

  https://api-eu.dhl.com/paket/versenden/v2.1/shipments?printFormat=A6
  

  官方文档可能存在版本滞后的情况，按这个位置传递就能避免报错。

• 错误原因解析

  • 放在请求头报错：2.1.1版本已不再支持通过请求头传递该参数，非标准请求头会被API拦截返回错误。
  • 放在JSON body返回400：请求体的Schema中没有printFormat字段定义，API识别为非法参数，直接返回400阻塞错误。
  • 默认配置不生效：若API请求中未指定printFormat，才会触发用户门户的默认配置；如果之前的请求有误（比如传了无效参数），会覆盖默认值导致不生效。

• 验证注意事项
  确保printFormat的值是API支持的合法选项，比如A4、A6、DL，注意大小写必须正确（小写会被判定为无效值）。

• 完整请求示例

  POST https://api-eu.dhl.com/paket/versenden/v2.1/shipments?printFormat=A6
  Authorization: Bearer YOUR_ACCESS_TOKEN
  Content-Type: application/json
  
  {
    "shipmentDetails": {
      "product": "V01PAK",
      "shipmentDate": "2024-05-20"
    },
    "sender": {
      "name": "Max Mustermann",
      "address": {
        "street": "Musterstraße",
        "houseNumber": "1",
        "postalCode": "12345",
        "city": "Berlin",
        "country": "DE"
      }
    },
    "recipient": {
      "name": "Erika Musterfrau",
      "address": {
        "street": "Beispielweg",
        "houseNumber": "2",
        "postalCode": "67890",
        "city": "Hamburg",
        "country": "DE"
      }
    }
  }
  

内容的提问来源于stack exchange，提问作者Eric Windmeier