{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-Hans/v2/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"引言"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api_v2.1e901ce90d31a1194fda3259c79eb82997f480a48868e29413bc9dd1355e5aac.c5aff763.png","alt":"Image description","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"引言","__idx":0},"children":["引言"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipSaving API V2是我们推出的新一代物流API接口体系。",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"该版本从底层架构开始重新设计，围绕性能、稳定性和可扩展性进行全面优化，旨在为合作伙伴和开发者提供",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["更可靠、更高效、更易维护"]},"的对接体验。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API V2不仅是对现有接口能力的升级，也是ShipSaving未来产品和技术发展的核心基础。"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["通过引入更加现代化的系统架构和接口设计方式，V2将支持更复杂的业务场景，并为后续功能扩展预留充足空间。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"核心亮点","__idx":1},"children":["核心亮点"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["现代化、模块化的接口架构"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"新版API采用更加清晰、模块化的设计思路，对不同功能进行合理拆分。接口职责更明确，有助于降低集成复杂度，也让后续维护和功能扩展更加高效。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["整体性能显著提升"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"在接口响应速度和数据处理效率方面进行了系统级优化，能更好地支持高并发请求和大批量出货场景，满足规模化物流业务的实际需求。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["更规范、统一的数据结构设计"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"接口返回字段更加统一，数据结构更稳定，减少不必要的差异和歧义。这不仅方便开发者解析数据，也能提升异常处理和调试时的效率。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["功能能力更全面"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"相比LegacyAPI（V1），API V2提供了更丰富的接口能力和配置选项，覆盖更多发货控制、订单处理以及高级业务场景，满足更复杂的业务需求。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["面向未来的系统设计"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"API V2与ShipSaving最新系统深度配合，是平台未来功能持续迭代的基础。后续新增能力将优先基于V2推出，确保接口长期可用、持续演进。"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"关于API V2的使用说明"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipSaving API V2是目前我们",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["主推且已稳定上线的 API版本"]},"，可以放心用于正式生产环境。不过，由于我们会分阶段逐步开放新功能和能力，在使用过程中，你可能会注意到它与LegacyAPI（V1）在部分细节或行为上存在差异。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在真实业务接入中，也有可能出现一些我们此前未覆盖到的使用场景。这些情况并不代表接口不稳定，反而是我们持续优化的重要依据。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["如果你在使用过程中发现："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["接口行为与预期不一致"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["某些V1中的功能在V2中尚未覆盖"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["或对接口设计有改进建议"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["欢迎随时向我们反馈。我们会结合实际使用情况，不断完善接口能力和整体开发体验。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"开始接入","__idx":2},"children":["开始接入"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["联系你的客户经理，申请API使用权限"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["获取API Key（支持测试环境与生产环境）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["查阅API V2接口文档，了解具体接口说明和参数定义"]}]}]},"headings":[{"value":"引言","id":"引言","depth":2},{"value":"核心亮点","id":"核心亮点","depth":2},{"value":"开始接入","id":"开始接入","depth":2}],"frontmatter":{"seo":{"title":"引言"}},"lastModified":"2026-08-26T18:17:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-hans/v2","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}