java-project/baiyue-firstleg
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: quote inline descriptions in Lingxing OpenAPI contract

Browse Source
This commit is contained in:
ouyangxq
2026-10-12 21:10:18 +08:00
parent b702ed9f45
commit 8526697b08
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
integration-service/src/main/resources/openapi/lingxing-wms-v1.yaml
+5 -5
View File
@@ -159,7 +159,7 @@ components:
additionalProperties: false additionalProperties: false
required: [sourceAccount, executionPurpose, rootTaskId, sessionId, attemptId, exclusiveGrantId] required: [sourceAccount, executionPurpose, rootTaskId, sessionId, attemptId, exclusiveGrantId]
properties: properties:
sourceAccount: {type: string, minLength: 1, maxLength: 64, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: Server-configured account alias, never App Key or Secret.} sourceAccount: {type: string, minLength: 1, maxLength: 64, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: 'Server-configured account alias, never App Key or Secret.'}
executionPurpose: {type: string, enum: [VALIDATION, BUSINESS]} executionPurpose: {type: string, enum: [VALIDATION, BUSINESS]}
rootTaskId: {type: string, minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: Stable root control identifier; child tasks share root budget.} rootTaskId: {type: string, minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: Stable root control identifier; child tasks share root budget.}
sessionId: {type: string, minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: Stable session control identifier; reopening or restart does not reset it.} sessionId: {type: string, minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]*$', description: Stable session control identifier; reopening or restart does not reset it.}
@@ -184,7 +184,7 @@ components:
required: [attemptId, actualHttpAttempts, accountPaused] required: [attemptId, actualHttpAttempts, accountPaused]
properties: properties:
attemptId: {type: string, nullable: true, description: Null only if no valid control context was accepted.} attemptId: {type: string, nullable: true, description: Null only if no valid control context was accepted.}
actualHttpAttempts: {type: integer, minimum: 0, maximum: 1, description: Supplier HTTP attempts actually started, including failed calls; authorization callbacks do not count.} actualHttpAttempts: {type: integer, minimum: 0, maximum: 1, description: 'Supplier HTTP attempts actually started, including failed calls; authorization callbacks do not count.'}
accountPaused: {type: boolean} accountPaused: {type: boolean}
cooldownUntil: {type: string, format: date-time, nullable: true, description: Account cooldown deadline to persist; valid supplier retry time must not be shortened.} cooldownUntil: {type: string, format: date-time, nullable: true, description: Account cooldown deadline to persist; valid supplier retry time must not be shortened.}
AuthorizationRequest: AuthorizationRequest:
@@ -262,7 +262,7 @@ components:
startTime: {type: string, example: '2026-09-12T08:00:00', description: Source local datetime. Must precede endTime and be no earlier than endTime minus one calendar month. No source timezone inference.} startTime: {type: string, example: '2026-09-12T08:00:00', description: Source local datetime. Must precede endTime and be no earlier than endTime minus one calendar month. No source timezone inference.}
endTime: {type: string, example: '2026-10-12T08:00:00'} endTime: {type: string, example: '2026-10-12T08:00:00'}
current: {type: integer, minimum: 1} current: {type: integer, minimum: 1}
size: {type: integer, minimum: 1, maximum: 100, description: Local request cap, not supplier quota.} size: {type: integer, minimum: 1, maximum: 100, description: 'Local request cap, not supplier quota.'}
LocateRequest: LocateRequest:
type: object type: object
required: [deliveryNo, current, size] required: [deliveryNo, current, size]
@@ -323,7 +323,7 @@ components:
properties: properties:
productSku: {type: string} productSku: {type: string}
productName: {type: string, nullable: true} productName: {type: string, nullable: true}
actualDeliveryQty: {type: number, nullable: true, description: BigDecimal actual quantity, unknown is null.} actualDeliveryQty: {type: number, nullable: true, description: 'BigDecimal actual quantity, unknown is null.'}
deliveryQty: {type: number, nullable: true, description: Forecast only; never a replacement for actual quantity.} deliveryQty: {type: number, nullable: true, description: Forecast only; never a replacement for actual quantity.}
OrderDetail: OrderDetail:
type: object type: object
@@ -396,7 +396,7 @@ components:
required: [code, message, data, timestamp] required: [code, message, data, timestamp]
properties: properties:
code: {type: string, description: '200 success; A0401 identity; A0422 validation; B0001 or S0503 provider/configuration failure.'} code: {type: string, description: '200 success; A0401 identity; A0422 validation; B0001 or S0503 provider/configuration failure.'}
message: {type: string, description: Sanitized fixed local message, never raw supplier content.} message: {type: string, description: 'Sanitized fixed local message, never raw supplier content.'}
requestId: {type: string, nullable: true} requestId: {type: string, nullable: true}
traceId: {type: string, nullable: true} traceId: {type: string, nullable: true}
timestamp: {type: string, format: date-time} timestamp: {type: string, format: date-time}