CN109508711A - 一种第三方接口的配置方法及装置 - Google Patents

Abstract

本发明公开了一种第三方接口的配置方法，包括：获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到；计算所述接口文档的识别结果的哈希值；解析所述接口文档的二维码，获得所述接口文档的哈希值；判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致，若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，则将所述接口文档的识别结果转换为预设格式的文件。本发明还公开了与所述方法相对应的一种第三方接口的配置装置。

Description

一种第三方接口的配置方法及装置

技术领域

本发明涉及接口配置领域，特别涉及一种第三方接口的配置方法及装置。

背景技术

目前，在对第三方接口配置过程中，需要按照接口文档中的规定对接口进行配置，但是往往拿到的接口文档是一份纸质的文档或者只是一纸质文档的扫描件。所以开发人员需要人工对照着纸质的接口文档，通过手工完成对接口的配置。

人工对照着纸质接口文档对接口进行配置，会因为开发人员的自身原因，出现看漏、看错或者是编写时，写漏、写错的情况。而且，有时候接口配置方拿到的是接口文档的扫描件，而纸质文件在扫描过程可能会出现一定程度的数据丢失，但开发人员并不知道所拿到的接口文档扫描件是否是完整的，依旧完全按照着扫描件进行接口配置。这些都会造成在接口配置过程中出现较高的差错率。而且错误往往在开发完成后进行联机时才会体现出来，这样大大的增加了开发项目的风险和费用。

因此，如何降低人工对照纸质文档进行接口配置带来的错误以及由于纸质文档扫描出现数据丢失而带来的差错，从而降低第三方接口配置的差错率，显得尤为重要。

发明内容

有鉴于此，本发明提供一种第三方接口的配置方法及装置，以有效降低第三方接口的配置过程中的差错率。

为实现上述目的，本发明实施例提供如下技术方案：

本发明一方面提供了一种第三方接口的配置方法，所述方法包括：

获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到；

计算所述接口文档的识别结果的哈希值；

解析所述接口文档的二维码，获得所述接口文档的哈希值；

判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致；

若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，则将所述接口文档的识别结果转换为预设格式的文件。

优选的，在上述的方法中，所述接口文档的二维码和所述接口文档存储于同一文件；

其中，所述解析所述接口文档的二维码，获得所述接口文档的哈希值；包括：

解析所述接口文档的存储文件中存储的接口文档的二维码，获得所述接口文档的哈希值。

优选的，在上述的方法中，所述接口文档的二维码的生成方法，包括：

计算得到所述接口文档的哈希值；

依据所述接口文档的哈希值，生成所述接口文档的二维码。

优选的，在上述的方法中，所述光学字符识别接口对接口文档进行识别，包括：

调用所述光学字符识别组件对接口文档进行识别。

优选的，在上述的方法中，还包括：

若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致，则返回获取接口文档的识别结果。

本发明另一方面提供了一种第三方接口的配置装置，所述装置包括：

获取单元，用于获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到；

第一计算单元，用于计算所述接口文档的识别结果的哈希值；

解析单元，用于解析所述接口文档的二维码，获得所述接口文档的哈希值；

判断单元，用于判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致；

转换单元，用于所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，将所述接口文档的识别结果转换为预设格式的文件。

优选的，在上述的装置中，所述接口文档的二维码和所述接口文档存储于同一文件；其中，所述解析单元，包括：

解析子单元，用于解析所述接口文档的存储文件中存储的接口文档的二维码，获得所述接口文档的哈希值。

优选的，在上述的装置中，还包括：

第二计算单元，用于计算得到所述接口文档的哈希值；

生成单元，用于依据所述接口文档的哈希值，生成所述接口文档的二维码，将所述接口文档的二维码和所述接口文档存储在一个文件中，生成接口文档的储存文件。

优选的，在上述的装置中，还包括：

调用单元，用于调用所述光学字符识别组件对接口文档进行识别。

优选的，在上述的装置中，还包括：

控制单元，用于在所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致，则控制所述获取单元执行获取接口文档的识别结果。

通过以上的方案可以看出，本发明所提供的第三方接口的配置方法中，通过光学识别组件识别接口文档，并最终将识别的结果转换为预设格式的文件，所述文件可以进行接口的配置。从而实现了将纸质的接口文档转换为可直接导入进行接口配置的电子版文件，使得对于接口的配置接近全自动化，不在需要人工对照纸质版的文件进行接口配置。在得到识别结果后，通过解析容错率较高的二维码，从纸质文件或纸质文档的扫描件中得到正确的接口文档的哈希值，然后利于了哈希值与数据的一一对应的关系，校验所述接口文档的识别结果与所述接口文档的一致性，确保了最终转换得到的文件与接口文档是完全一致的，保证了接口配置的正确性。通过上述的方式，从而降低了扫描过程中出现部分数据丢失和人为因素所带来的较高的差错率。

附图说明

为了更清楚地说明本发明实施例或现有技术中的技术方案，下面将对实施例或现有技术描述中所需要使用的附图作简单地介绍，显而易见地，下面描述中的附图仅仅是本发明的实施例，对于本领域普通技术人员来讲，在不付出创造性劳动的前提下，还可以根据提供的附图获得其他的附图。

图1为本发明实施例第三方接口的配置方法的流程图；

图2为本发明另一具体实施例所述方法的流程图；

图3为本发明实施例第三方接口的配置装置的示意图。

具体实施方式

下面将结合本发明实施例中的附图，对本发明实施例中的技术方案进行清楚、完整地描述，显然，所描述的实施例仅仅是本发明一部分实施例，而不是全部的实施例。基于本发明中的实施例，本领域普通技术人员在没有做出创造性劳动前提下所获得的所有其他实施例，都属于本发明保护的范围。

如图1所示，本发明实施例提供了一种第三方接口的配置方法，包括：

S101、获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到。

其中，所述接口文档可以是纸质的文档或是纸质版文档的扫描件，而进行接口配置的一方往往只能收到这样形式的文档。比如，商业银行的***与第三方接口配置的要求，是由财政方面下发接口文档进行规定的。而银行往往就是只能拿到纸质的接口文档或是纸质文档的扫描件。

需要说明的是，光学字符识别(Optical CharacterRecognition，简称OCR)是指是通过检测暗、亮的模式确定其形状，然后用字符识别方法将形状翻译成计算机文字的过程；即，针对印刷体字符，采用光学的方式将纸质文档中的文字转换成为黑白点阵的图像文件，并通过识别软件将图像中的文字转换成文本格式，供文字处理软件进一步编辑加工的技术。所以可以采用光学字符识别组件对接口文档进行识别，识别解析接口文档中的字段名、字段长度、字段类型等，将纸质文档的内容转换为计算机字符，从而可以得到接口文档的识别结果。

可选地，可以通过调用现有的光学字符识别组件对接口文档进行识别。现在很多商家都在提供调用的光学字符识别组件，供第三方使用，所以可以通过编写程序调用已有的光学字符识别接口，就可调用到已有光学字符识别组件来进行文档识别，既方便又快捷。当然，这是一种优选的方式，除了调用现有的光学字符识别组件外，也可以单独配置新的组件来进行识别，而不采用现有的光学字符识别组件。只是这样会使得方法的实现变得复杂，成本也会增加。

S102、计算所述接口文档的识别结果的哈希值。

需要说明的是，所述哈希值是通过哈希算法将任意长度的二进制值映射为固定长度的较小二进制值，也就是这个小的二进制值称为哈希值。也就是，根据所述接口文档识别结果利用哈希算法计算就可以得到所述接口文档的哈希值。

S103、解析所述接口文档的二维码，获得所述接口文档的哈希值。

其中，所述接口文档的哈希值承载于接口文档的二维码，因此，解析所述接口文档的二维码，得到所述接口文档的二维码中承载的接口文档的哈希值。

可选地，所述接口文档的二维码的生成的方法是，当接口文档被确定后，先利用哈希算法对所述接口文档进行计算，得到所述接口文档的哈希值，然后根据所述接口文档的哈希值，生成所述接口文档的二维码，即所述接口文档的哈希值存储在所述接口文档的二维码中。

二维码在编码生成的过程中会进行冗余，就像是123会被编码成123123123，这样即使二维码的部分丢失、损坏或者被遮挡，只要能扫描到部分的二维码，而该部分中依然有很大概率包含有123，这样还是可以得到二维码所包含的完整的信息。所以将所述接口文档的哈希值存储在二维码中，即使是在后续的文件传递或者扫描过程中，二维码出现了不可避免的部分缺失，依然能得到完整的所述接口文件的哈希值。

可选地，可以将所述接口文档和所述接口文档的二维码存储在同一存储文件中。对于纸质的文件，就是将接口文档和所述接口文档的二维码打印在同一份文件上。两者存储在同一文件内，可以有效的避免整个二维码的丢失，或是二维码被弄混淆，与接口文档不对应，方便了文件的管理。当然，这只是一个优选的方案，二维码与接口的文档如何存储并不影响本发明的实现，比如可以将接口文档和接口文档的二维码都单独的存储在一个文件内，进行单独的管理。

所以，其中所述解析接口文档的二维码，获得所述接口文档的哈希值，可以是解析所述接口文档的存储文件的接口文档的二维码，从而获得所述接口文档的哈希值。

S104、判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致。

其中，本申请通过判断所述接口文档的识别结果的哈希值与所述接口的哈希值的一致性，从而确认所述接口文档的识别结果与所述接口文档一致性。因为，根据上述可知，哈希值是根据哈希算法计算得到的，而哈希算法又称散列函数或散列算法，是一种从任何一种数据中创建小的数字“指纹”的方法。哈希算法把消息或数据压缩成摘要，使得数据量变小，将数据的格式固定下来。该函数将数据打乱混合，重新创建一个叫做哈希值的指纹。哈希值是一段数据唯一且极其紧凑的数值表示形式。如果散列一段明文而且哪怕只更改该段落的一个字母，随后的计算都将产生不同的值。要找到散列为同一个值的两个不同的输入，在计算上来说基本上是不可能的。所以哈希值与数据是存在着一一对应关系的，利用同一哈希算法，计算相同的数据会得到相同的结果，计算两个只是有细微的差别的数据，则会的得到不同的哈希值。所以对接口文档计算得出所述接口文档的哈希值，然后用相同的哈希算法计算出识别结果的哈希值。通过判断所述接口文档的哈希值和所述接口文档的识别结果的哈希值是否一致，就可以知道所述接口文档与所述接口文档的哈希值是否一致。当两者的哈希值一致时，说明识别结果和接口文档是完全一致的。

若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，则执行步骤S105、将所述接口文档的识别结果转换为预设格式的文件。

其中，预设的格式可以为一种，也可以为多种。所述预设格式，根据具体的需要进行预设。比如，可以预设为xml文件和excel文件，得到的xml文件就可以直接导入，对接口进行配置。得到的excel文件，可用于存档，方便后续开发人员的查询和使用。

本发明提供的另一具体实施例，参见图2，所述第三方接口的配置方法，除包括步骤S201～步骤S205之外，还包括：

在步骤S204中，判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致时，则返回步骤S201。

相应的，在得到新的识别结果后，还需要进行后续的步骤。重新的识别可以弥补之前识别出现的错误或遗漏，从而得到正确的识别结果。

其中，本实施例中，步骤S201～步骤S205的内容，与上述实施例中步骤S101～步骤S105的内容相同，此处不再赘述。

本发明另一实施例还提供了一种第三方接口的配置装置，参见图3所示，所述装置包括：

获取单元，用于获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到。

第一计算单元，用于计算所述接口文档的识别结果的哈希值。

解析单元，用于解析所述接口文档的二维码，获得所述接口文档的哈希值。

可选地，本申请的另一实施例中，所述接口文档的二维码和所述接口文档存储于同一文件中。所述解析单元，包括解析子单元。所述解析子单元，用于解析所述接口文档的存储文件中存储的接口文档的二维码，从而获得所述接口文档的哈希值。

判断单元，用于判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致。

转换单元，用于所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，将所述接口文档的识别结果转换为预设格式的文件。也就是，可以在所述转换单元中根据需要设置所需的格式，所预设的格式可以为多种，所述转换单元就会转换生成相应格式的文件。

可选地，在上述实施例所提供的装置中，还可以进一步包括：调用单元、第二计算单元和生成单元。

所述调用单元，用于调用现有的光学字符识别组件，对接口文档进行识别。通过调用现有的商用的光学字符识别接口，就可以利用该接口对于的光学字符识别组件，对接口文档进行识别，从而得到所述接口文档的识别结果。

所述第二计算单元，用于根据所述接口文档，计算得到所述接口文档的哈希值。需要说明的是，为了能采用所述接口文档的识别结果的哈希值与所述接口文档的哈希值的一致性，来确定所述接口文档的识别结果与所述接口文档的一致性，所述第一计算单元与第二计算单元应该利用相同的散列函数来进行计算，从而得到哈希值。

所述生产单元，用于依据所述第二计算单元所计算得到的所述接口文档的哈希值，生产所述接口文档的二维码，将所述接口文档的二维码和所述接口文档存储在一个文件中，生成接口文档的储存文件。所述二维码可以按最高纠错等级生成，所述最高纠错等级就是二维码最大被遮挡30％时，依旧能扫描解析得到所述该二维码所包含的完整信息。从而最大程度的保证，能得到所述接口文档的哈希值。

为了能自动的重新识别所述接口文档，在本发明的另一实施例中，还可以进一步包括：控制单元。

所述控制单元，用于在所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致，则控制所述获取单元执行获取接口文档的识别结果。也就是从新获取所述接口文档的识别结果，相应的也要进行后续的步骤。

本申请上述实施例中，各个单元的具体执行过程，可参见对应的方法实施例的内容，此处不再赘述。

专业技术人员能够实现或使用本发明。对这些实施例的多种修改对本领域的专业技术人员来说将是显而易见的，本文中所定义的一般原理可以在不脱离本发明的精神或范围的情况下，在其它实施例中实现。因此，本发明将不会被限制于本文所示的这些实施例，而是要符合与本文所公开的原理和新颖特点相一致的最宽的范围。

Claims (10)

1.一种第三方接口的配置方法，其特征在于，包括：

获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到；

计算所述接口文档的识别结果的哈希值；

解析所述接口文档的二维码，获得所述接口文档的哈希值；

判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致；

若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，则将所述接口文档的识别结果转换为预设格式的文件。

2.根据权利要求1所述的方法，其特征在于，所述接口文档的二维码和所述接口文档存储于同一文件；

其中，所述解析所述接口文档的二维码，获得所述接口文档的哈希值；包括：

解析所述接口文档的存储文件中存储的接口文档的二维码，获得所述接口文档的哈希值。

3.根据权利要求1所述的方法，其特征在于，所述接口文档的二维码的生成方法，包括：

计算得到所述接口文档的哈希值；

依据所述接口文档的哈希值，生成所述接口文档的二维码。

4.根据权利要求1所述的方法，其特征在于，所述光学字符识别接口对接口文档进行识别，包括：

调用所述光学字符识别组件对接口文档进行识别。

5.根据权利要求1至4中任意一项所述的方法，其特征在于，还包括：

若判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致，则返回获取接口文档的识别结果。

6.一种第三方接口的配置装置，其特征在于，包括：

获取单元，用于获取接口文档的识别结果，所述识别结果是光学字符识别组件对所述接口文档进行识别得到；

第一计算单元，用于计算所述接口文档的识别结果的哈希值；

解析单元，用于解析所述接口文档的二维码，获得所述接口文档的哈希值；

判断单元，用于判断所述接口文档的识别结果的哈希值与所述接口文档的哈希值是否一致；

转换单元，用于所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值一致，将所述接口文档的识别结果转换为预设格式的文件。

7.根据权利要求6所述的装置，其特征在于，所述接口文档的二维码和所述接口文档存储于同一文件；其中，所述解析单元，包括：

解析子单元，用于解析所述接口文档的存储文件中存储的接口文档的二维码，获得所述接口文档的哈希值。

8.根据权利要求6所述的装置，其特征在于，还包括：

第二计算单元，用于计算得到所述接口文档的哈希值；

生成单元，用于依据所述接口文档的哈希值，生成所述接口文档的二维码，并将所述接口文档的二维码和所述接口文档存储在一个文件中，生成接口文档的储存文件。

9.根据权利要求6所述的装置，其特征在于，还包括：

调用单元，用于调用所述光学字符识别组件对接口文档进行识别。

10.根据权利要求5至9中任意一项所述的装置，其特征在于，还包括：

控制单元，用于在所述判断单元判断出所述接口文档的识别结果的哈希值与所述接口文档的哈希值不一致，则控制所述获取单元执行获取接口文档的识别结果。