使用Fedex Ship API下载标签PDF时遇SHIPPING.DOCUMENT.NO.BYTES错误

我通过FedEx Ship v1 API生成运单标签，但无法通过返回的URL下载标签。

相关信息 #

• 标签下载URL：
  https://wwwtest.fedex.com/document/v1/cache/retrieve/SH,f15d003851096ec9794972069960_SHIPPING_Z?isLabel=true&autoPrint=false&retrievalMode=THERMAL

• 请求返回的错误响应：

{
    "transactionId": "94bb8cb1-e6d2-430a-a100-9850a57513b2",
    "errors": [
        {
            "code": "SHIPPING.DOCUMENT.NO.BYTES",
            "message": "We are unable to process this request. Please try again later or contact FedEx Customer Service."
        }
    ]
}

• 我使用的PHP请求代码：

<?php
$url = "https://wwwtest.fedex.com/document/v1/cache/retrieve/SH,f15d003851096ec9794972069960_SHIPPING_Z?isLabel=true&autoPrint=false&retrievalMode=THERMAL";

$arrContextOptions=array(
      "ssl"=>array(
            "verify_peer"=>false,
            "verify_peer_name"=>false,
        ),
    );

$response = file_get_contents($url, false, stream_context_create($arrContextOptions));
?>

可行的排查与解决方向 #

• 添加身份验证头：FedEx文档缓存接口需要携带生成运单时使用的认证信息，比如在请求头中加入Authorization: Bearer {你的访问令牌}，当前请求未做身份验证是大概率的问题根源。
• 确认URL有效期：FedEx的临时缓存URL通常有效期较短，若生成后间隔太久再请求会失效，需重新调用运单生成接口获取新的标签URL。
• 修复SSL验证设置：禁用SSL验证（verify_peer=false）存在安全风险，测试环境建议使用FedEx提供的可信证书，生产环境必须开启SSL验证。
• 补充必要请求头：尝试添加Accept头指定标签格式，比如Accept: application/pdf或Accept: image/png，确保接口返回对应格式的标签文件。
• 联系FedEx客服：如果以上方法无效，提供响应中的transactionId给FedEx技术支持，他们可以查询具体的错误细节。

内容的提问来源于stack exchange，提问作者Stéphane Escaich