API 与 ERP 集成
DGAssistant 如何与贵公司的 ERP、仓储管理系统或发运平台相衔接。
使用 API 是否需要专门的模块？
是。API 属于在标准许可之外单独授权的模块。待贵公司决定集成时，将其加入订阅即可。
API 的用量如何计量与计价？
API 按许可计量：每份许可每年涵盖 1 500 票托运货物与 7 500 次服务调用，并允许数据库保存最多 5 000 个非托运货物对象，例如产品与各当事方（收货人、供应商、驾驶员等）。若预计用量更高，增购许可即可。API 模块的具体单价与其余目录一并列示于本公司商城，亦可纳入任何定制报价。
使用 API 的两种方式分别是什么：批量还是交互？
批量方式以单次服务调用接收托运货物的完整说明——当 ERP 已掌握货物、各当事方与数量时最为适用。交互方式则可逐步组建托运货物，并在添加每项货物时即时校验；此方式更接近网页版软件的工作流程，适合需要在 API 之上构建由用户主导的操作流程的情形。
产品与各当事方应预先建立，还是随调用即时传入？
两种方式均受支持。建议采用「预定义数据」：在网页版软件中一次性建立（或导入）产品与各当事方，随后在 API 调用中以其代码引用。「即时传入」方式则在每次调用中传送全部内容，当贵公司的 ERP 为该等数据的主数据源且不希望预先加载时较为便利。
如何通过 API 获取生成的 PDF 文件？
有两种方式。您可在 API 响应中以 base64 编码的 PDF 形式接收各项单证（运输单证、托运人申报单、检查表、货包标记等），亦可由平台自动将其以电子邮件发送至指定地址。
由 API 生成的单证可以自动打印吗？
可以。两种做法均行之有效：(a) 由贵公司 ERP 自 API 下载 PDF 文件并送入自有打印队列；(b) 由 DGAssistant 将单证发送至指定邮箱，再由贵方的小型自动打印工具送至相应打印机。许多客户选择邮件方式，因其在 ERP 侧无须另行编写代码。
API 规范在哪里查阅？
完整的 OpenAPI 规范（含交互式示例）发布于危险货物 API 文档。我们另提供预置了贴近实际测试调用的 SoapUI 项目，便于贵公司的开发人员在数分钟内完成探索。
requestGuid 是什么，为何必须提供？
每次 API 调用均须包含一个唯一的 requestGuid，用以在我们的日志中标识该请求；当贵公司报告问题时，支持团队可据此准确定位相应事务。任何唯一的字母数字值均可接受；建议在客户端生成标准的 UUID/GUID。
API 调用首次失败最常见的原因是什么？
服务未予接受的凭据：缺失或错误的 HTTP Basic Authorization 请求头；若调用采用 OAuth2 鉴权，则可能是从未申请过、属于其他环境或业已过期的访问令牌。另设有专用的支持地址，可供调用以确认 API 处于可用状态且凭据有效。若仍无法解决，请将完整的 HTTP 请求与响应（含 requestGuid）以及预期行为的说明发送给我们——这是最快的解决途径。