危险货物 REST API

该 API 的功能

托运货物。DGAssistant 的 JSON REST API 可自贵方的管理或物流系统创建危险货物托运，并返回托运人申报单、检查清单与货包标记，且均已依照适用法规完成校验。商务数据留在贵方系统；法规知识与单证由 DGAssistant 提供。

拼箱。该 API 同样涵盖多个托运人货物的归集，并沿两条主线展开。合同主线是总托运货物——订舱、海运或空运拼箱、公路拼车——包含其相关方、各类参考号、所挂靠的托运货物、状态流转与历史记录。实物主线是运输组件（集装箱、车辆、挂车或集装器）与运输行程（航次、航班或行程）及其挂靠港站，并包含账户下的船舶、车辆与地点。本服务半数以上的内容均用于这一部分。

打开危险货物 API 规范

两种调用方式：批量与交互

批量。单次调用即携带托运货物的完整规格及其全部货物。此方式面向发送已组装完毕托运货物的管理与物流系统。

交互。先创建托运货物，再逐项添加货物。每次返回均带有刚添加内容的校验提示，使贵方应用程序可在办理过程中向用户展示。

预设数据或即时数据

预设数据。产品与相关方——托运人、承运人、收货人、装货人与驾驶员——事先创建，API 直接引用其编码。这是最简便的方式，也是我们推荐的方式，因为法规分类一次确定，此后每批托运货物均可复用。

即时数据。产品与相关方在创建托运货物的同一次调用中定义。适用于不维护自有目录或仅偶尔发运危险货物的系统。

可返回的单证

每批托运货物均可返回：适用法规的托运人申报单、检查清单与货包标记。可取得 PDF、XLSX 或 DOCX 格式，亦可直接由本服务通过电子邮件发送。

拼箱业务可返回：运输组件的单证、运输行程的单证（其中包括危险货物舱单与致船长通知书），以及总托运货物的单证。

该 API 的校验内容

在托运货物层面。同车（船、机）运输货物之间的隔离要求、适用包装说明以及有限数量与例外数量制度的数量限值、货物对该运输方式的可运性、包装的合法性以及申报的完整性。若存在不符，返回内容会指明未满足的规则及相应数值，以便在贵方应用程序中展示。

在拼箱层面。运输组件内部的隔离、同一行程中所装各组件之间的隔离、按 ADR 1.1.3.6 计算该行程限值并给出明细，以及以数据形式返回的行程限制，例如隧道限制代码或是否载有高危后果危险货物。

所涵盖的法规与运输方式

公路适用 ADR，海运适用 IMDG，空运适用 IATA，并涵盖 49 CFR。三大法规统一管理而非各自独立模块，因此更换运输方式的托运货物无须重新办理。

混合包装、集合包装、罐体、散装运输、空的未清洁包装、废物以及第 7 类放射性物质均获支持，并附各自所需的数据项。单证文本可以十九种语言输出。

可用性

本服务在三个区域发布——欧洲、美洲与亚太——各有独立地址，使对接与账户所在区域相对应。基础设施采用冗余配置并接受全天候监控。

如何开始

申请为期两周的免费试用，并同时取得服务凭据。身份验证采用 OAuth 2.0 的「client credentials」方式：贵方系统获取访问令牌，并在每次请求中发送。

完整规范以 OpenAPI 格式发布，可在编写任何一行对接代码之前阅读、查阅，并据以生成贵方所用语言的客户端。