DHL Express · 单件运价与货件业务 API 文档

按MyDHL规范读取单件运价，规范亦描述货件、取件与跟踪；只适用已获准客户及其自有DHL货件，不是开放转售比价数据。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

根据本次实际读取的官方资料整理，未认领，不代表提供者授权或独立认证。原能力范围：Account-based international express rating, shipment labels, pickups, and tracking。本轮未执行能力，也不因收录而授予安装、认证、资料分享、收费或业务提交权限。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-54561d3438c75b747ce3b969 · 版本 2 · 保存此版本引用

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

单件运价GET /rates官方规范候选；需DHL凭据及客户账号，费用未知，未报价或下单。

调用方式 / profile：dhl-single-piece-rates-documentation · 组件版本：documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd · 引用此版本与调用方式

已记录条件

invocation_mode = api：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e1
auth_required = true：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e1
account_required = true：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e2
output_format = json：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e3
output_structure = json_object：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e4
execution_location = remote：支持。Supported within this profile and component version. 依据：dhl-single-piece-rates-documentation-e5
runtime_os = windows：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：
cpu_only = true：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：
gpu_required = false：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：
runtime_network_required = false：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：
setup_network_required = true：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：
setup_required = true：未知（可能存在冲突或待复核）。本精确文档profile缺少该条件的适用证明；操作/格式字典未涵盖本领域时不借其他值冒充。未执行本机/远端能力调用，未核验安装、账户、费用或隐私。依据：

入口与前提

协议: https GET
认证: DHL MyDHL服务凭据HTTP Basic与客户accountNumber；本站无凭据核验
价格是否查明: unknown
配额是否查明: unknown

https://express.api.dhl.com/mydhlapi/rates

proposed；需合法服务访问、Basic凭据和有效客户accountNumber；本站未持有/核验。
仅单件GET /rates；规范/接口版本3.3.4不等于实际服务版本或本站测试。
价格、税费、附加费、配额、地址隐私与商业条款待核验；本期不调用、上传收件信息或创建订单。

配方 dhl-single-piece-rates-documentation-recipe · 修订 1

所需调用能力：

quote_single_piece_shipping

运行前提：

proposed；需合法服务访问、Basic凭据和有效客户accountNumber；本站未持有/核验。
仅单件GET /rates；规范/接口版本3.3.4不等于实际服务版本或本站测试。
价格、税费、附加费、配额、地址隐私与商业条款待核验；本期不调用、上传收件信息或创建订单。

使用步骤：

按规范准备起讫国家/城市、账号、单件重量和三边、plannedShippingDate、isCustomsDeclarable及unitOfMeasurement。
未来接入候选为GET https://express.api.dhl.com/mydhlapi/rates，HTTP Basic与x-version: 3.3.4；不填入真实凭据/私人地址。
待获适用授权执行后检查HTTP状态、products[]、币种/价格字段及业务条件，不将报价当下单承诺。

输入约定: 单件发运必填query参数与x-version header；不是JSON请求体；邮编schema optional不免除业务规则。
输出约定: 文档200 application/json对象及products[]，可含totalPrice币种/价格；实际结果与字段存在性未确认。
成功检查: 待接入：处理400/500与业务错误，核对单件/单位/日期/币种；不得把单件报价扩成多件或下单。
失败与回退: 无凭据/账号或业务条件不满足即保持待接入；不改用付费替代、不调用POST下单或取件。

适用证据

dhl-single-piece-rates-documentation-e1 · 来源文档声明

原始来源

原文定位: .local/deep-cards-v1/expansion-20261024-01/sources/dhl.txt:L379-L389
来源版本: documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
内容摘要: f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
采集时间: 2026-10-20T11:34:56.8010810+00:00

/rates: get: summary: Retrieve Rates for a one piece Shipment security: - basicAuth: [] description: > The Rate request will return DHL's product capabilities and prices (where applicable) based on the input data. Using the shipper and receiver address as well as the dimension and weights of the pieces belonging to a shipment, this operation returns the available products including the shipping price (where applicable)

覆盖条件：invocation_mode=api; auth_required=true

dhl-single-piece-rates-documentation-e2 · 来源文档声明

原始来源

原文定位: .local/deep-cards-v1/expansion-20261024-01/sources/dhl.txt:L9432-L9439
来源版本: documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
内容摘要: f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
采集时间: 2026-10-20T11:34:56.8010810+00:00

accountNumber: name: accountNumber in: query description: DHL Express customer account number required: true example: 123456789 schema: type: string

覆盖条件：account_required=true

dhl-single-piece-rates-documentation-e3 · 来源文档声明

原始来源

原文定位: .local/deep-cards-v1/expansion-20261024-01/sources/dhl.txt:L423-L428
来源版本: documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
内容摘要: f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
采集时间: 2026-10-20T11:34:56.8010810+00:00

'200': description: Rates found content: application/json: schema: $ref: '#/components/schemas/supermodelIoLogisticsExpressRates'

覆盖条件：output_format=json

dhl-single-piece-rates-documentation-e4 · 来源文档声明

原始来源

原文定位: .local/deep-cards-v1/expansion-20261024-01/sources/dhl.txt:L15844-L15864
来源版本: documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
内容摘要: f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
采集时间: 2026-10-20T11:34:56.8010810+00:00

supermodelIoLogisticsExpressRates: title: 'Definition of /rates, /landed-cost response message' description: Comment describing your JSON Schema type: object properties: products: title: products type: array items: type: object properties: productName: description: DHL Express product - Global Product Name type: string example: EXPRESS DOMESTIC productCode: description: >- This is the global DHL Express product code for which the delivery is feasible respecting the input data from the request. type: string example: 'N'

覆盖条件：output_structure=json_object

dhl-single-piece-rates-documentation-e5 · 来源文档声明

原始来源

原文定位: .local/deep-cards-v1/expansion-20261024-01/sources/dhl.txt:L9302-L9308
来源版本: documentation-sha256:f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
内容摘要: f46b8cf79e43963b9b3873f4d10caf8a40d085c2fec70304aa8deaca2d2699cd
采集时间: 2026-10-20T11:34:56.8010810+00:00

servers: - url: 'https://api-mock.dhl.com/mydhlapi' description: 'Mock Server (simulate API responses with fixed test data)' - url: 'https://express.api.dhl.com/mydhlapi/test' description: 'Test Environment' - url: 'https://express.api.dhl.com/mydhlapi' description: 'Production Environment'

覆盖条件：execution_location=remote

结构化配方尚未提供或不适用于本版本；旧用法文字保留，连接与执行结果未知。

稳定标识: cap-54561d3438c75b747ce3b969
名片版本: 2
资料更新: 2026-10-31T00:09:28.2447656+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

必填query：accountNumber、originCountryCode、originCityName、destinationCountryCode、destinationCityName、weight、length、width、height、plannedShippingDate、isCustomsDeclarable、unitOfMeasurement。
必填header x-version=3.3.4；unitOfMeasurement为metric或imperial；邮编schema为可选但业务地址规则仍适用。

输出

单件可用products、productCode、重量和totalPrice[].priceCurrency、totalPrice[].price；文档列200及400/500错误结构，未取得业务响应。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：账号。需活跃DHL Express账户和已开通API凭据，预先发送HTTP Basic；该操作使用basicAuth，不把其他安全定义当额外必需API key。凭据本轮未取得。

运行前提

获准客户凭据和自有货件业务目的；按实际环境区分test/production；正确账号、地址和计量信息。
仅按合同使用运输数据；不得因发现接口就把运价转给第三方或建立比价数据服务。
真实请求须在用户已授权的资料、费用、行为及提供者条款范围内；本轮不建立任何权限。

公开请求示例

{
  "headers": {
    "x-version": "3.3.4"
  },
  "note": "\u4E0D\u542B\u8D26\u53F7\u503C\u6216\u51ED\u636E\uFF1B\u6240\u6709\u5B9E\u9645\u8C03\u7528\u9700\u4E8B\u5148\u4E1A\u52A1\u6388\u6743\u3002",
  "path": "/rates",
  "required_query_names": [
    "accountNumber",
    "originCountryCode",
    "originCityName",
    "destinationCountryCode",
    "destinationCityName",
    "weight",
    "length",
    "width",
    "height",
    "plannedShippingDate",
    "isCustomsDeclarable",
    "unitOfMeasurement"
  ]
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。实际账户运价、附加费和税费按路线及合同核对；报价/时效只是指示，可能不含全部费用，不填真实价格。

价格来源 · 提供者条款

资料去向

提供者服务器。账号、地址、运输和必要海关信息进入DHL运输流程；按产品条款取得所需数据授权。开发者门户隐私不能泛化为运输数据处理合同。

限制

主例GET /rates仅单件，多件另用POST /rates；3.3.4是接口规范/header版本，不是本机软件版本。
同规范的POST /shipments、POST /pickups会产生业务状态；GET tracking也需合法货件范围；本例不执行这些操作。
未经DHL事先书面同意不得向第三方提供Product/Rating Data；不得存储或修改这类数据，竞争性分析/推导须事先书面许可。
Landed Cost仅B2B，不得重包装/转售/建库；创建运输订单却不交运可能产生补偿。
API预约不等于承运合同成立，需交件/取件后DHL接受；测试环境每日500次不代表生产额度。
Developer Portal隐私页只覆盖网站/开发者账号，运输资料边界按产品条款；不声称完整运输隐私合同已审计。

仍需核对

实际账户/项目/商户权限、目标地区可达性及真实配额未验证。
真实费用、具体资料许可接受、功能结果、长期可靠性及端到端任务未验证。
仅核对所列文档范围，不代表全部服务/隐私合同、地区资格或第三方权利已清除。

提交者报告的验证

仅查阅资料 · 未测试

仅本次官方文档及对应描述文件读取/正文审核。没有执行API业务请求、注册/登录账户、创建下载追踪、估价、商店、订单、标签、预约、配送或任何业务状态；来源HTTP可读不等于能力通过。

日期: 2026-10-20T11:34:56.801081+00:00
软件版本: 未知

实际检查

逐源保留实际请求/最终URL、HTTP/MIME、带时区UTC、响应字节SHA及正文定位。
核对调用方式、鉴权范围、费用、许可和副作用边界；拒绝、跳转和壳页面不冒充目标事实。

未验证范围

实际账户/项目/商户权限、目标地区可达性及真实配额未验证。
真实费用、具体资料许可接受、功能结果、长期可靠性及端到端任务未验证。
仅核对所列文档范围，不代表全部服务/隐私合同、地区资格或第三方权利已清除。

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

DHL Express / reviewed official source 1 · 官方文档 · 2026-10-20T11:30:04.299667+00:00
DHL Express / reviewed official source 2 · 官方文档 · 2026-10-20T11:32:31.471429+00:00
DHL Express / reviewed official source 3 · 官方文档 · 2026-10-20T11:32:32.653289+00:00
DHL Express / reviewed official source 4 · 官方文档 · 2026-10-20T11:34:56.801081+00:00

提交者自述：NavoNavo API documentation review。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developer.dhl.com/api-reference/dhl-express-mydhl-api",
  "final_url": "https://developer.dhl.com/api-reference/dhl-express-mydhl-api",
  "status_code": 200,
  "title": "MyDHL API (DHL Express)",
  "description": null,
  "checked_at": "2026-10-20T11:56:49.5961255\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-54561d3438c75b747ce3b969",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developer.dhl.com/api-reference/dhl-express-mydhl-api"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。