提交

2026-11-03 16:51:30 +08:00
parent 1506576c67
commit 5d6b2812cf
11 changed files with 354 additions and 0 deletions
@@ -0,0 +1,62 @@
+openapi: 3.0.3
+info:
+  title: 客户本土散板及卡车运输照片
+  version: 1.0.0
+  description: 只读当前客户商业原单的已保存取货和派送凭证。散板按当前货物与审核轮次过滤，混排不披露其他客户或其他订单照片；卡车沿有效运输关联读取取货和完成凭证。上传但未绑定、已删除和已取消安排的照片不可读取。
+paths:
+  /api/merchant/v1/last-leg/local-looseboard-orders/{orderNo}/transport-photos:
+    get:
+      summary: 本客户散板原单取货和派送照片
+      description: 使用 merchant:cross-border:pallet-shipping:list 权限及 Token 客户范围。
+      parameters: [{ $ref: '#/components/parameters/OrderNo' }]
+      responses:
+        '200': { $ref: '#/components/responses/Photos' }
+  /api/merchant/v1/last-leg/us-truck-orders/{orderNo}/transport-photos:
+    get:
+      summary: 本客户卡车原单取货和派送凭证
+      description: 使用 merchant:cross-border:domestic-trucking:list 权限及 Token 客户范围。
+      parameters: [{ $ref: '#/components/parameters/OrderNo' }]
+      responses:
+        '200': { $ref: '#/components/responses/Photos' }
+  /api/merchant/v1/last-leg/local-looseboard-orders/{orderNo}/transport-photos/{phase}/{fileId}/content:
+    get:
+      summary: 读取本客户散板已保存节点照片
+      description: 同散板列表权限；按原单、节点和文件引用重新授权，返回 no-store 及 nosniff。
+      parameters: [{ $ref: '#/components/parameters/OrderNo' }, { $ref: '#/components/parameters/Phase' }, { $ref: '#/components/parameters/FileId' }]
+      responses:
+        '200': { description: 文件二进制或统一业务失败响应, content: { application/octet-stream: { schema: { type: string, format: binary } } } }
+  /api/merchant/v1/last-leg/us-truck-orders/{orderNo}/transport-photos/{phase}/{fileId}/content:
+    get:
+      summary: 读取本客户卡车已保存节点凭证
+      description: 同卡车列表权限；按原单、节点和文件引用重新授权，返回 no-store 及 nosniff。
+      parameters: [{ $ref: '#/components/parameters/OrderNo' }, { $ref: '#/components/parameters/Phase' }, { $ref: '#/components/parameters/FileId' }]
+      responses:
+        '200': { description: 文件二进制或统一业务失败响应, content: { application/octet-stream: { schema: { type: string, format: binary } } } }
+components:
+  parameters:
+    OrderNo: { name: orderNo, in: path, required: true, schema: { type: string } }
+    Phase: { name: phase, in: path, required: true, schema: { type: string, enum: [PICKUP, ARRIVAL] } }
+    FileId: { name: fileId, in: path, required: true, schema: { type: string, pattern: '^[1-9][0-9]*$' } }
+  responses:
+    Photos:
+      description: HTTP 200统一业务响应；成功 code 为字符串200，data包含两类照片，空集合不生成虚构凭证。
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              code: { type: string }
+              message: { type: string }
+              data:
+                type: object
+                properties:
+                  pickupPhotos: { type: array, items: { $ref: '#/components/schemas/Photo' } }
+                  arrivalPhotos: { type: array, items: { $ref: '#/components/schemas/Photo' } }
+  schemas:
+    Photo:
+      type: object
+      properties:
+        fileId: { type: string }
+        fileName: { type: string }
+        contentType: { type: string }
+        sizeBytes: { type: integer, format: int64 }