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