@cpzxrobot/sdk 1.3.122 → 1.3.124

package/aiform_gateway.ts

@@ -9,6 +9,7 @@ import type {
   AiformTemplateHistoryResponse,
   AiformTemplatePublishResponse,
   AiformReplyResponse,
+  AiformReplyDetailResponse,
   AiformConfirmResponse,
   AiformReplyListResponse,
 } from ".";
@@ -79,19 +80,22 @@ export class AiformGateway extends Object {
        * @param templateId 模板ID（可选，与factoryId二选一）
        * @param factoryId 工厂ID（可选，与templateId二选一）
        */
-      uploadTemplateImage: async (templateId: number | null, factoryId?: number): Promise<any> => {
+      uploadTemplateImage: async (args: {
+        templateId?: number;
+        factoryId?: number;
+      }): Promise<any> => {
         const axios = await this.context.ready;
 
-        if (!templateId && !factoryId) {
+        if (!args.templateId && !args.factoryId) {
           throw new Error('模板ID和工厂ID至少需要传一个');
         }
 
         const data: any = {};
-        if (templateId) {
-          data.templateId = templateId;
+        if (args.templateId) {
+          data.templateId = args.templateId;
         }
-        if (factoryId) {
-          data.factoryId = factoryId;
+        if (args.factoryId) {
+          data.factoryId = args.factoryId;  
         }
 
         return axios.upload(`/api/v2/aiform/template/upload`,{
@@ -243,11 +247,13 @@ export class AiformGateway extends Object {
       },
 
       /**
-       * 根据reply_id获取解析结果
+       * 按 replyId 轮询结果
+       * GET /api/v2/aiform/file/detail/reply/{replyId}
        * @param replyId reply记录ID
-       * @returns Promise 包含解析结果详情
+       * @returns Promise 包含 replyId、status、result 和 accessUrl
+       * 注意：用于轮询 reply 的处理状态，status=1 处理中，status=2 成功，status=0 失败
        */
-      getReplyDetail: async (replyId: number): Promise<AiformFileDetailResponse> => {
+      getReplyDetail: async (replyId: number): Promise<AiformReplyDetailResponse> => {
         const axios = await this.context.ready;
 
         if (!replyId) {
@@ -264,9 +270,11 @@ export class AiformGateway extends Object {
 
       /**
        * 根据解析结果提交反馈（reply）
+       * POST /api/v2/aiform/file/reply
        * @param code 文件业务编码
        * @param reply 用户的修改意见/反馈内容
-       * @returns Promise 包含调整后的解析结果
+       * @returns Promise 包含 replyId、status 和 accessUrl
+       * 注意：接口为异步，立即返回 replyId 与 status=1，需使用 getReplyDetail 按 replyId 轮询直至 status=2 或 0
        */
       reply: async (code: string, reply: string): Promise<AiformReplyResponse> => {
         const axios = await this.context.ready;

package/dist/aiform_gateway.js

@@ -67,17 +67,17 @@ class AiformGateway extends Object {
              * @param templateId 模板ID（可选，与factoryId二选一）
              * @param factoryId 工厂ID（可选，与templateId二选一）
              */
-            uploadTemplateImage: (templateId, factoryId) => __awaiter(this, void 0, void 0, function* () {
+            uploadTemplateImage: (args) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;
-                if (!templateId && !factoryId) {
+                if (!args.templateId && !args.factoryId) {
                     throw new Error('模板ID和工厂ID至少需要传一个');
                 }
                 const data = {};
-                if (templateId) {
-                    data.templateId = templateId;
+                if (args.templateId) {
+                    data.templateId = args.templateId;
                 }
-                if (factoryId) {
-                    data.factoryId = factoryId;
+                if (args.factoryId) {
+                    data.factoryId = args.factoryId;
                 }
                 return axios.upload(`/api/v2/aiform/template/upload`, {
                     title: "请选择表格图片",
@@ -209,9 +209,11 @@ class AiformGateway extends Object {
                 });
             }),
             /**
-             * 根据reply_id获取解析结果
+             * 按 replyId 轮询结果
+             * GET /api/v2/aiform/file/detail/reply/{replyId}
              * @param replyId reply记录ID
-             * @returns Promise 包含解析结果详情
+             * @returns Promise 包含 replyId、status、result 和 accessUrl
+             * 注意：用于轮询 reply 的处理状态，status=1 处理中，status=2 成功，status=0 失败
              */
             getReplyDetail: (replyId) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;
@@ -227,9 +229,11 @@ class AiformGateway extends Object {
             }),
             /**
              * 根据解析结果提交反馈（reply）
+             * POST /api/v2/aiform/file/reply
              * @param code 文件业务编码
              * @param reply 用户的修改意见/反馈内容
-             * @returns Promise 包含调整后的解析结果
+             * @returns Promise 包含 replyId、status 和 accessUrl
+             * 注意：接口为异步，立即返回 replyId 与 status=1，需使用 getReplyDetail 按 replyId 轮询直至 status=2 或 0
              */
             reply: (code, reply) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpzxrobot/sdk",
-  "version": "1.3.122",
+  "version": "1.3.124",
   "description": "提供给上海正芯数智APP第三方H5应用使用的SDK",
   "main": "dist/index.js",
   "scripts": {

package/types.d.ts

@@ -933,8 +933,36 @@ interface AiformReplyResponse {
   code: number;
   /** 提示信息 */
   message: string;
-  /** 调整后的解析结果 */
-  data: AiformParseResultVO;
+  /** 提交结果 */
+  data: {
+    /** 新建 aiform_reply.id，用于轮询 */
+    replyId: number;
+    /** 提交后恒为 1 */
+    status: number;
+    /** 原图预签名链接（便于前端展示） */
+    accessUrl: string;
+  };
+}
+
+/**
+ * Reply轮询响应接口
+ */
+interface AiformReplyDetailResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 轮询结果 */
+  data: {
+    /** 本条 reply 主键 */
+    replyId: number;
+    /** 状态：1处理中，2成功，0失败 */
+    status: number;
+    /** 仅 status=2 且已落库时有值 */
+    result?: AiformParseResultVO;
+    /** 原图预签名链接 */
+    accessUrl: string;
+  };
 }
 
 /**
@@ -1235,6 +1263,7 @@ declare module "@cpzxrobot/sdk" {
     AiformFileListResponse,
     AiformFileDetailResponse,
     AiformReplyResponse,
+    AiformReplyDetailResponse,
     AiformConfirmResponse,
     AiformRecordReply,
     AiformReplyListResponse,