1、调整导航树列表顺序

2、更新【获取自建应用授权】 3、更新【获取企业对账单列表】 4、更新【更新日志】 5、更新【更新单据】 6、优化部分接口参数描述
ekuaibao · Nov 8, 2023 · ca94bab · ca94bab
1 parent e6ef65b
commit ca94bab
Show file tree

Hide file tree

Showing 19 changed files with 51 additions and 61 deletions.
diff --git a/docs/open-api/getting-started/auth-getAppAccessToken.md b/docs/open-api/getting-started/auth-getAppAccessToken.md
@@ -1,4 +1,4 @@
-# 获取自建应用授权（新）
+# 获取自建应用授权
 
 import Control from "@theme/Control";
 

diff --git a/docs/open-api/getting-started/platform-auth.md b/docs/open-api/getting-started/platform-auth.md
@@ -1,4 +1,4 @@
-# 获取自建应用授权
+# 获取自建应用授权（旧）
 
 import Control from "@theme/Control";
 

diff --git a/docs/open-api/getting-started/question-answer.md b/docs/open-api/getting-started/question-answer.md
@@ -46,30 +46,23 @@ A：此处设置的重定向URL为所有跳转链接的前站，一般为二开
 
 ---
 
-[//]: # (## 问题四)
+## 问题四
 
-[//]: # (### Q：[获取自建应用授权]&#40;/docs/open-api/getting-started/platform-auth&#41; 时如何获取接入账号和密码？)
+### Q：[获取自建应用授权](/docs/open-api/getting-started/auth-getAppAccessToken) 时如何获取接入账号和密码？
 
-[//]: # ()
-[//]: # (A：需要进入【合思】→【合思+】→【自建应用】，查看应用凭证的 App ID 和 App Secret。具体操作步骤如下：<br/>)
+A：需要进入【合思】→【合思+】→【自建应用】，查看应用凭证的 App ID 和 App Secret。具体操作步骤如下：<br/>
 
-[//]: # ()
-[//]: # (#### （1）【合思+】入口)
+#### （1）【合思+】入口
+
+![image](images/getAccessTokenNew1.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/getAccessTokenNew1.png&#41;)
+#### （2）点击“自建应用”，选择任意一个应用进入
 
-[//]: # ()
-[//]: # (#### （2）点击“自建应用”，选择任意一个应用进入)
+![image](images/自建应用位置.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/自建应用位置.png&#41;)
+#### （3）查看应用凭证，点击“显示”，获取 App ID 和 App Secret
 
-[//]: # ()
-[//]: # (#### （3）查看应用凭证，点击“显示”，获取 App ID 和 App Secret)
+![image](images/接入账号和密码.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/接入账号和密码.png&#41;)
 
-[//]: # ()
-[//]: # (---)
+---
diff --git a/docs/open-api/inside/info.md b/docs/open-api/inside/info.md
@@ -10,7 +10,7 @@ authors: [冯继成]
 
 ---
 ## 开始使用
-### [获取自建应用授权（新）](/docs/open-api/getting-started/auth-getAppAccessToken)
+### [获取自建应用授权（旧）](/docs/open-api/getting-started/platform-auth)
 
 ---
 ## 企业通讯录

diff --git a/docs/open-api/mall/find-pageData-billId.md b/docs/open-api/mall/find-pageData-billId.md
@@ -31,8 +31,8 @@ url="/api/mall-openapi/open-api/finance/bill/findPageDataBillId"
 | 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
 | :--- | :--- | :--- | :--- |:--- | :--- |
 | **productTypeId**| Integer | 产品类型ID   | 非必填 | - | **不传时查询全部类型**<br/>`1` : 酒店 &emsp; `2` : 机票 &emsp; `3` : 火车 &emsp; `4` : 用车<br/>`5` : 餐饮 &emsp; `6` : 通用 &emsp; `7` : 保险 &emsp; `8` : 虚拟卡 &emsp; `10` : 企业购 |
-| **startTime**    | Long    | 查询开始时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间请在一个月内** |
-| **endTime**      | Long    | 查询结束时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间请在一个月内** |
+| **startTime**    | Long    | 查询开始时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间间隔不能超过一个月** |
+| **endTime**      | Long    | 查询结束时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间间隔不能超过一个月** |
 | **page**         | Integer | 第几页       | 必填 | - | `page` ≥ `1` |
 | **size**         | Integer | 每页数量     | 必填 | - | `0` < `size` ≤ `50` |
 | **requestId**    | String  | 请求标识     | 必填 | - | 任意填写即可，用于接口查询出错时，记录日志 |

diff --git a/docs/open-api/notice/update-log.md b/docs/open-api/notice/update-log.md
@@ -13,8 +13,9 @@ timeline: true
 
 ## 1.25.0
 
-`2023-XX-XX`&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`代码版本：XX`
+`2023-11-08`&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`代码版本：9.123.5`
 
+- 🆕 新增 [获取自建应用授权](/docs/open-api/getting-started/auth-getAppAccessToken) 接口。
 - 🆕 新增 [查询人员信用分数](/docs/open-api/datalink-extend/get-credit-byStaffId) 接口。
 
 ---

diff --git a/sidebars.js b/sidebars.js
@@ -42,10 +42,10 @@ const sidebars = {
         "open-api/getting-started/postman-use",
         "open-api/getting-started/origin",
         "open-api/getting-started/auth",
-        // "open-api/getting-started/platform-auth",
         "open-api/getting-started/refresh-auth",
-        "open-api/getting-started/refresh-auth-expireDate",
-        "open-api/getting-started/temp-auth",
+          "open-api/getting-started/refresh-auth-expireDate",
+          "open-api/getting-started/auth-getAppAccessToken",
+          "open-api/getting-started/temp-auth",
         "open-api/getting-started/question-answer"
       ],
     },

diff --git a/versioned_docs/version-v2.2/open-api/datalink-extend/invoice-multiple_items.md b/versioned_docs/version-v2.2/open-api/datalink-extend/invoice-multiple_items.md
@@ -19,7 +19,7 @@ url="/api/openapi/v2/invoice/multiple_items"
 </details>
 
 :::caution
-- 需要开通【**OCR智能识别**】和【**发票查验功能**】，方可使用本接口。
+- 需要开通【**OCR智能识别**】和【**发票查验**】功能，方可使用本接口。
 - 本接口限制 **QPS=1**（1次/秒）。
 :::
 

diff --git a/...oned_docs/version-v2.2/open-api/datalink-extend/invoice-validate-byInvoiceId.md b/...oned_docs/version-v2.2/open-api/datalink-extend/invoice-validate-byInvoiceId.md
@@ -19,7 +19,7 @@ url="/api/openapi/v2/invoice/validateByInvoiceId"
 </details>
 
 :::caution
-- 需要开通【**发票查验功能**】，方可使用本接口。
+- 需要开通【**发票查验**】功能，方可使用本接口。
 - 本接口限制 **QPS=1**（1次/秒）。
 :::
 

diff --git a/versioned_docs/version-v2.2/open-api/datalink-extend/invoice-validate.md b/versioned_docs/version-v2.2/open-api/datalink-extend/invoice-validate.md
@@ -19,7 +19,7 @@ url="/api/openapi/v2/invoice/validate"
 </details>
 
 :::caution
-- 需要开通【**发票查验功能**】，方可使用本接口。
+- 需要开通【**发票查验**】功能，方可使用本接口。
 - 本接口限制 **QPS=1**（1次/秒）。
 :::
 

diff --git a/versioned_docs/version-v2.2/open-api/flows/update-form.md b/versioned_docs/version-v2.2/open-api/flows/update-form.md
@@ -321,12 +321,13 @@ curl --location --request PUT 'https://app.ekuaibao.com/api/openapi/v2.2/flow/da
 
 ## 失败响应
 
-| HTTP状态码 | 错误码 | 描述 | 排查建议 |
-| :--- | :--- | :--- | :--- |
-| **400** | - | 单据模板不存在 | `form.specificationId`（单据模板ID）错误，请确认单据模板ID是否为 **单据模板ID:小版本号** 的正确形式  | 
-| **400** | - | 此节点未配置允许审批人修改单据选项，请检查审批流 | 请确认单据当前审批节点是否配置【允许审批人修改单据】  | 
-| **403** | - | 您没有权限执行此操作 | 请确认 `editorId`（单据修改人）是否为单据审批人  | 
-| **412** | - | 请填写 "****" 字段 | 请确认该字段是否必填，如果配置了字段依赖性或自动计算，确认按照逻辑可以计算得到值  | 
+| HTTP状态码 | 错误码 | 描述 | 排查建议                                                                |
+| :--- | :--- | :--- |:--------------------------------------------------------------------|
+| **400** | - | 单据模板不存在 | `form.specificationId`（单据模板ID）错误，请确认单据模板ID是否为 **单据模板ID:小版本号** 的正确形式 | 
+| **400** | - | 此节点未配置允许审批人修改单据选项，请检查审批流 | 请确认单据当前审批节点是否配置【允许审批人修改单据】                                          | 
+| **400** | - | 此单据已被提交，请刷新页面查看 | 单据已被审批完成，不允许通过接口修改。                                                 | 
+| **403** | - | 您没有权限执行此操作 | 请确认 `editorId`（单据修改人）是否为单据审批人                                       | 
+| **412** | - | 请填写 "****" 字段 | 请确认该字段是否必填，如果配置了字段依赖性或自动计算，确认按照逻辑可以计算得到值                            | 
 
 
 ## 字段填写规则

diff --git a/versioned_docs/version-v2.2/open-api/getting-started/auth-getAppAccessToken.md b/versioned_docs/version-v2.2/open-api/getting-started/auth-getAppAccessToken.md
@@ -1,4 +1,4 @@
-# 获取自建应用授权（新）
+# 获取自建应用授权
 
 import Control from "@theme/Control";
 

diff --git a/versioned_docs/version-v2.2/open-api/getting-started/platform-auth.md b/versioned_docs/version-v2.2/open-api/getting-started/platform-auth.md
@@ -1,4 +1,4 @@
-# 获取自建应用授权
+# 获取自建应用授权（旧）
 
 import Control from "@theme/Control";
 

diff --git a/versioned_docs/version-v2.2/open-api/getting-started/question-answer.md b/versioned_docs/version-v2.2/open-api/getting-started/question-answer.md
@@ -46,30 +46,23 @@ A：此处设置的重定向URL为所有跳转链接的前站，一般为二开
 
 ---
 
-[//]: # (## 问题四)
+## 问题四
 
-[//]: # (### Q：[获取自建应用授权]&#40;/docs/open-api/getting-started/platform-auth&#41; 时如何获取接入账号和密码？)
+### Q：[获取自建应用授权](/docs/open-api/getting-started/auth-getAppAccessToken) 时如何获取接入账号和密码？
 
-[//]: # ()
-[//]: # (A：需要进入【合思】→【合思+】→【自建应用】，查看应用凭证的 App ID 和 App Secret。具体操作步骤如下：<br/>)
+A：需要进入【合思】→【合思+】→【自建应用】，查看应用凭证的 App ID 和 App Secret。具体操作步骤如下：<br/>
 
-[//]: # ()
-[//]: # (#### （1）【合思+】入口)
+#### （1）【合思+】入口
+
+![image](images/getAccessTokenNew1.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/getAccessTokenNew1.png&#41;)
+#### （2）点击“自建应用”，选择任意一个应用进入
 
-[//]: # ()
-[//]: # (#### （2）点击“自建应用”，选择任意一个应用进入)
+![image](images/自建应用位置.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/自建应用位置.png&#41;)
+#### （3）查看应用凭证，点击“显示”，获取 App ID 和 App Secret
 
-[//]: # ()
-[//]: # (#### （3）查看应用凭证，点击“显示”，获取 App ID 和 App Secret)
+![image](images/接入账号和密码.png)
 
-[//]: # ()
-[//]: # (![image]&#40;images/接入账号和密码.png&#41;)
 
-[//]: # ()
-[//]: # (---)
+---
diff --git a/versioned_docs/version-v2.2/open-api/inside/info.md b/versioned_docs/version-v2.2/open-api/inside/info.md
@@ -10,7 +10,7 @@ authors: [冯继成]
 
 ---
 ## 开始使用
-### [获取自建应用授权（新）](/docs/open-api/getting-started/auth-getAppAccessToken)
+### [获取自建应用授权（旧）](/docs/open-api/getting-started/platform-auth)
 
 ---
 ## 企业通讯录

diff --git a/versioned_docs/version-v2.2/open-api/mall/find-pageData-billId.md b/versioned_docs/version-v2.2/open-api/mall/find-pageData-billId.md
@@ -31,8 +31,8 @@ url="/api/mall-openapi/open-api/finance/bill/findPageDataBillId"
 | 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
 | :--- | :--- | :--- | :--- |:--- | :--- |
 | **productTypeId**| Integer | 产品类型ID   | 非必填 | - | **不传时查询全部类型**<br/>`1` : 酒店 &emsp; `2` : 机票 &emsp; `3` : 火车 &emsp; `4` : 用车<br/>`5` : 餐饮 &emsp; `6` : 通用 &emsp; `7` : 保险 &emsp; `8` : 虚拟卡 &emsp; `10` : 企业购 |
-| **startTime**    | Long    | 查询开始时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间请在一个月内** |
-| **endTime**      | Long    | 查询结束时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间请在一个月内** |
+| **startTime**    | Long    | 查询开始时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间间隔不能超过一个月** |
+| **endTime**      | Long    | 查询结束时间  | 必填 | - | 毫秒级时间戳，按对账单 **创建时间** 查询<br/>**查询开始时间和结束时间间隔不能超过一个月** |
 | **page**         | Integer | 第几页       | 必填 | - | `page` ≥ `1` |
 | **size**         | Integer | 每页数量     | 必填 | - | `0` < `size` ≤ `50` |
 | **requestId**    | String  | 请求标识     | 必填 | - | 任意填写即可，用于接口查询出错时，记录日志 |

diff --git a/versioned_docs/version-v2.2/open-api/notice/update-log.md b/versioned_docs/version-v2.2/open-api/notice/update-log.md
@@ -13,8 +13,9 @@ timeline: true
 
 ## 1.25.0
 
-`2023-XX-XX`&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`代码版本：XX`
+`2023-11-08`&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`代码版本：9.123.5`
 
+- 🆕 新增 [获取自建应用授权](/docs/open-api/getting-started/auth-getAppAccessToken) 接口。
 - 🆕 新增 [查询人员信用分数](/docs/open-api/datalink-extend/get-credit-byStaffId) 接口。
 
 ---

diff --git a/versioned_docs/version-v2.2/open-api/pay/get-payerInfos-search.md b/versioned_docs/version-v2.2/open-api/pay/get-payerInfos-search.md
@@ -39,7 +39,7 @@ url="/api/openapi/v4/payerInfos/search"
 
 ## CURL
 ```shell
-curl --location --request POST 'https://app.ekuaibao.com/api/openapi/v4/payerInfos/search?accessToken=ID_3GTWsF30aqg:Urf3lsFgBp00gw&ids=&names=&cardNos=&start=0&count=100&active=true'
+curl --location --request GET 'https://app.ekuaibao.com/api/openapi/v4/payerInfos/search?accessToken=ID01u8vU7V5leC%3ATdk3tgber501v0&ids=&names=&cardNos=&start=0&count=10&active=true'
 ```
 
 ## 成功响应

diff --git a/versioned_sidebars/version-v2.2-sidebars.json b/versioned_sidebars/version-v2.2-sidebars.json
@@ -18,6 +18,7 @@
         "open-api/getting-started/auth",
         "open-api/getting-started/refresh-auth",
         "open-api/getting-started/refresh-auth-expireDate",
+        "open-api/getting-started/auth-getAppAccessToken",
         "open-api/getting-started/temp-auth",
         "open-api/getting-started/question-answer"
       ]