From 8596e3493676e3b818baa73c6148455ad4e1ec3e Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Wed, 4 Nov 2026 09:24:55 +0800 Subject: [PATCH] =?UTF-8?q?docs(lingxing):=20=E6=A0=87=E6=B3=A8=E5=BF=AB?= =?UTF-8?q?=E9=80=9F=E5=87=BA=E5=BA=93=E4=B8=BA=E5=86=99=E6=93=8D=E4=BD=9C?= =?UTF-8?q?=EF=BC=8C=E9=AA=8C=E8=AF=81=E9=98=B6=E6=AE=B5=E7=A6=81=E6=AD=A2?= =?UTF-8?q?=E8=B0=83=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 领星无测试环境,出库会真实改变数据: - LingxingApi.FAST_OUTBOUND 注释标明写操作,禁止验证 - MultiPlatformOutboundSource 类注释与 submit 方法注释同步标注 - FAST_OUTBOUND_RESULT 注明只读、可安全验证 约定已记入项目记忆:领星验证只做查询。 Co-Authored-By: Claude --- lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java | 8 ++++++-- .../multiplatform/outbound/MultiPlatformOutboundSource.java | 5 +++++ 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java index 2c7fc1b..7d929e7 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java @@ -88,10 +88,14 @@ public enum LingxingApi { /** 亚马逊结算中心交易明细。POST,offset/length 分页,上限 10000。 */ SETTLEMENT_TRANSACTION_LIST("/bd/sp/api/open/settlement/transaction/detail/list", 10), - /** 快速出库(创建异步出库任务)。POST,qps 10,多平台通用。 */ + /** + * 快速出库(创建异步出库任务)。POST,qps 10,多平台通用。 + * + *

写操作:会改变领星侧数据。领星无测试环境,禁止在验证阶段调用。

+ */ FAST_OUTBOUND("/pb/mp/order/v2/fastOutbound", 10), - /** 快速出库结果查询。POST,qps 10,多平台通用。 */ + /** 快速出库结果查询。POST,qps 10,多平台通用。只读,可安全验证。 */ FAST_OUTBOUND_RESULT("/pb/mp/order/v2/getFastOutboundResult", 10), /** 多平台订单列表;当前实现使用的跨平台接口。 */ diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java index 6037c1d..daca648 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java @@ -27,6 +27,10 @@ import java.util.Map; * * *

两个接口的令牌桶都是 10 req/s。

+ * + *

验证限制:{@link #submit} 会真实创建出库任务、改变领星数据, + * 而领星没有测试环境,因此不得用于联调验证; + * {@link #results} 是只读查询,可安全调用。

*/ public final class MultiPlatformOutboundSource implements LingxingOutboundSource { @@ -36,6 +40,7 @@ public final class MultiPlatformOutboundSource implements LingxingOutboundSource private static final String OP_SUBMIT = "outbound.submit"; private static final String OP_RESULTS = "outbound.results"; + /** 提交出库任务。写操作,会改变领星数据,验证阶段禁止调用。 */ @Override public boolean submit(LingxingCall call, List packages) { if (packages == null || packages.isEmpty()) {