接口文档的上传方法、装置及存储介质与流程

1.本发明涉及互联网后端开发技术领域，具体而言，涉及一种接口文档的上传方法、装置及存储介质。


背景技术：

2.目前，在java后端开发工作中，作为连接前后端的中间媒介，接口文档的编写是必不可少的。大多数企业会选择将接口文档记录在本地部署的yapi接口管理平台上，因此会造成接口修改更新的困难，当前用户只能先将接口文档上传至接口管理平台，在上传完成后，通过在接口管理平台实现对接口进行修改，而且，对于接口文档的上传，当在接口管理平台内未检索到目标接口文档时，不能实现在本地获取接口文档的地址链接目录。
3.有鉴于此，特提出本发明。


技术实现要素：

4.本发明要解决的技术问题在于克服现有技术的不足，提供一种接口文档的上传方法，从而实现在本地可以对接口进行更新，简化开发人员的操作步骤。
5.为解决上述技术问题，本发明采用技术方案的基本构思是：根据本发明实施例的第一方面，提供一种接口文档的上传方法，包括：基于用户在编译平台对接口文档进行修改，得到目标接口文档；在接口管理平台内对所述目标接口文档进行检索，响应于未检索到所述目标接口文档，则根据用户指定的地址链接上传所述接口文档至接口管理平台；响应于接收到用户发送的指定地址链接，则基于所述指定地址链接，上传所述目标接口文档至接口管理平台。
6.可选的，所述上传所述目标接口文档至接口管理平台，包括：响应于未接收到用户发送的指定地址链接，则获取所述接口管理平台内的接口可用地址链接目录，基于用户选择的目标地址链接，上传所述目标接口文档至接口管理平台。
7.可选的，所述在接口管理平台内对所述目标接口文档进行检索，还包括：响应于检索到所述目标接口文档，则对所述目标接口文档对应的接口进行更新。
8.可选的，所述基于用户在intelij dea编译平台的预览界面对接口文档的自定义修改，得到目标接口文档，包括：调用intelij dea编译平台中的插件sequencediagram生成uml时序图；将所述uml时序图插入所述接口文档中，得到第一接口文档；根据接口管理平台对接口文档格式的要求，转化所述第一接口文档格式为目标格式，得到目标接口文档。
9.可选的，所述intelij dea编译平台的预览界面的生成方法，包括：在目标代码编写完成的情况下，响应于监听到用户下发的插件指令，显示第一代码辅助功能界面，其中，所述第一代码辅助功能界面用于选择目标插件；显示第二代码辅助功能界面，其中，所述第二代码辅助功能界面用于选择所述目标插件的目标接口；整合所述目标接口的相关信息，自动生成接口文档预览界面。
10.可选的，所述目标接口的相关信息，包括：所述目标接口的参数信息，其中，所述参
数信息包括：输入参数和返回参数信息；基于目标代码文件中的javadoc注释和javaparser的解析，获取所述目标代码文件方法名或方法类名的数据信息。
11.可选的，所述将所述接口文档上传至接口管理平台，包括：响应于接收到用户端发送的首次上传请求，则配置账户名和密码，并向接口管理平台发送验证请求；获取接口管理平台返回的登陆验证token；响应于接收到用户端发送的非首次上传所述接口文档至接口管理平台的上传请求，则根据提前配置好的账户名和密码自动登陆验证token；上传所述接口文档至接口管理平台，并返回所述接口文档的地址信息至用户端。
12.根据本发明实施例的第二方面，提供一种接口文档的上传装置，包括：修改模块，被配置为基于用户在编译平台对接口文档进行修改，得到目标接口文档；第一上传模块，被配置为在接口管理平台内对所述目标接口文档进行检索，响应于未检索到所述目标接口文档，则根据用户指定的地址链接上传所述接口文档至接口管理平台；第二上传模块，被配置为响应于接收到用户发送的指定地址链接，则基于所述指定地址链接，上传所述目标接口文档至接口管理平台。
13.可选的，所述第二上传模块用于上传所述目标接口文档至接口管理平台，包括：响应于未接收到用户发送的指定地址链接，则获取所述接口管理平台内的接口可用地址链接目录，基于用户选择的目标地址链接，上传所述目标接口文档至接口管理平台。
14.可选的，所述第一上传模块用于在接口管理平台内对所述目标接口文档进行检索，还包括：响应于检索到所述目标接口文档，则对所述目标接口文档对应的接口进行更新。
15.可选的，所述修改模块用于基于用户在intelij dea编译平台的预览界面对接口文档的自定义修改，得到目标接口文档，包括：调用intelij dea编译平台中的插件sequencediagram生成uml时序图；将所述uml时序图插入所述接口文档中，得到第一接口文档；根据接口管理平台对接口文档格式的要求，转化所述第一接口文档格式为目标格式，得到目标接口文档。
16.可选的，所述修改模块用于intelij dea编译平台的预览界面的生成方法，包括：在目标代码编写完成的情况下，响应于监听到用户下发的插件指令，显示第一代码辅助功能界面，其中，所述第一代码辅助功能界面用于选择目标插件；显示第二代码辅助功能界面，其中，所述第二代码辅助功能界面用于选择所述目标插件的目标接口；整合所述目标接口的相关信息，自动生成接口文档预览界面。
17.可选的，所述修改模块中目标接口的相关信息，包括：所述目标接口的参数信息，其中，所述参数信息包括：输入参数和返回参数信息；基于目标代码文件中的javadoc注释和javaparser的解析，获取所述目标代码文件方法名或方法类名的数据信息。
18.可选的，所述第三上传模块用于将所述接口文档上传至接口管理平台，包括：响应于接收到用户端发送的首次上传请求，则配置账户名和密码，并向接口管理平台发送验证请求；获取接口管理平台返回的登陆验证token；响应于接收到用户端发送的非首次上传所述接口文档至接口管理平台的上传请求，则根据提前配置好的账户名和密码自动登陆验证token；上传所述接口文档至接口管理平台，并返回所述接口文档的地址信息至用户端。
19.根据本发明实施例的第三方面，提供一种电子装置，包括存储器和处理器，其中，所述存储器中存储有计算机程序，所述处理器被设置为通过所述计算机程序执行权利要求
第一方面提出的任一项所述接口文档的上传方法。
20.根据本发明实施例的第四方面，提供一种计算机可读存储介质，其上存储有计算机程序指令，该程序指令被处理器执行时用于实现本公开第一方面或第一方面任意一种所述实施方式所提供的接口文档的上传方法。
21.采用上述技术方案后，本发明与现有技术相比具有以下有益效果：基于用户在intelij dea编译平台的预览界面对接口文档进行自定义修改，得到目标接口文档；在接口管理平台内对所述目标接口文档进行检索，响应于未检索到所述目标接口文档，则根据用户指定的地址链接上传所述接口文档至接口管理平台；响应于接收到用户发送的指定地址链接，则基于所述指定地址链接，上传所述目标接口文档至接口管理平台；响应于未接收到用户发送的指定地址链接，则获取所述接口管理平台内的接口可用地址链接目录，基于用户选择的目标地址链接，上传所述目标接口文档至接口管理平台的方法，可以实现在本地获取接口管理平台内接口的地址链接目录，实现在本地对接口文档的上传，并当需要更新接口时，可以通过在本地上传实现对接口的更新，无需在代码中进行配置便可生成清晰有效的接口文档，从而简化了接口文档的上传办法，为开发人员提供了便利。
22.下面结合附图对本发明的具体实施方式作进一步详细的描述。
附图说明
23.此处的附图被并入说明书中并构成本说明书的一部分，示出了符合本发明的实施例，并与说明书一起用于解释本发明的原理。
24.为了更清楚地说明本发明实施例或现有技术中的技术方案，下面将对实施例或现有技术描述中所需要使用的附图作简单地介绍，显而易见地，对于本领域普通技术人员而言，在不付出创造性劳动性的前提下，还可以根据这些附图获得其他的附图。
25.图1是根据本发明实施例的一种智能设备的交互方法的硬件环境示意图；
26.图2是根据本发明实施例的一种接口文档的上传方法的流程图；
27.图3是根据本发明实施例的一种接口文档自动生成及上传过程的交互示意图；
28.图4是根据本发明实施例的一种用于接口文档的上传装置的框图；
29.图5是根据本发明实施例的一种电子装置的框图。
30.需要说明的是，这些附图和文字描述并不旨在以任何方式限制本发明的构思范围，而是通过参考特定实施例为本领域技术人员说明本发明的概念。
具体实施方式
31.为了使本技术领域的人员更好地理解本发明方案，下面将结合本发明实施例中的附图，对本发明实施例中的技术方案进行清楚、完整地描述，显然，所描述的实施例仅仅是本发明一部分的实施例，而不是全部的实施例。基于本发明中的实施例，本领域普通技术人员在没有做出创造性劳动前提下所获得的所有其他实施例，都应当属于本发明保护的范围。
32.需要说明的是，本发明的说明书和权利要求书及上述附图中的术语“第一”、“第二”等是用于区别类似的对象，而不必用于描述特定的顺序或先后次序。应该理解这样使用的数据在适当情况下可以互换，以便这里描述的本发明的实施例能够以除了在这里图示或
描述的那些以外的顺序实施。此外，术语“包括”和“具有”以及他们的任何变形，意图在于覆盖不排他的包含，例如，包含了一系列步骤或单元的过程、方法、系统、产品或设备不必限于清楚地列出的那些步骤或单元，而是可包括没有清楚地列出的或对于这些过程、方法、产品或设备固有的其它步骤或单元。
33.根据本发明实施例的一个方面，提供了一种智能家居设备的交互方法。该智能家居设备的交互方法广泛应用于智慧家庭(smart home)、智能家居、智能家用设备生态、智慧住宅(intelligence house)生态等全屋智能数字化控制应用场景。可选地，在本实施例中，上述智能家居设备的交互方法可以应用于如图1所示的由终端设备102和服务器104所构成的硬件环境中。如图1所示，服务器104通过网络与终端设备102进行连接，可用于为终端或终端上安装的客户端提供服务(如应用服务等)，可在服务器上或独立于服务器设置接口管理平台，用于为服务器104提供数据存储服务，可在服务器上或独立于服务器配置云计算服务，用于为服务器104提供数据运算服务。
34.上述网络可以包括但不限于以下至少之一：有线网络，无线网络。上述有线网络可以包括但不限于以下至少之一：广域网，城域网，局域网，上述无线网络可以包括但不限于以下至少之一：wifi(wireless fidelity，无线保真)，蓝牙。终端设备102包括可以使用intelij dea编译器的设备。
35.实施例一
36.作为连接前端和后端的重要工具，接口文档的编写是必不可少的。接口文档又叫(规范性文档)，接口文档有规范的格式和内容要求，后端按照接口协议接收前端传递的合法数据和返回符合的规范的数据，前端按照接口协议传递符合规范的数据和对后端返回的数据依据展示的需要做处理。目前很多企业在java后端开发工作中编写接口文档会选择将接口文档记录在本地部署的yapi平台上，但是随着接口的迭代以及业务的变更，接口文档的管理和维护变得越来越困难，而且由于接口文档中一个复杂接口往往会有很多参数和返回值，因此开发人员编写过程会很枯燥，并且会有很多遗漏。目前intellij dea中存在一些能够将本地接口生成文档或事yapi格式的文档的插件，比如yapiupload及其衍生easyyapi，但此类插件均是文件夹级别的操作，而接口的更新往往是单独接口的更新，在一些项目中由于一个文件夹下有多个接口，因此要在一个文件夹下选中要更新的接口比较麻烦，而且此类插件可塑性较差，生成的内容有限，且当需要接口其他必要内容时，需要在java代码中重新下进行配置，因此会造成配置次数过多的情况，配置次数过多则会造成业务代码被无用代码入侵，导致代码可读性降低；在配置完成后，当前导出接口文档的方式是基于javadoc&kdoc&scaladoc等方式直接解析代码对应的api文档，并从接口文档中提取所需内容并导出，基于当前接口文档部署与yapi平台上，因此当导出至yapi平台时，需要通过yapi官方提供的开放api接口进行上传，当登录验证过期之后，需要重新获取登录验证码，会造成配置延时的问题。
37.因此，本发明提供一种插件实现无需在代码中进行配置便可生成清晰有效的接口文档，以及接口时序图，实现能够针对单个新增的接口进行操作，对接口文档、时序图进行预览和修改，并且实现可以通过只配置用户名、密码的方式实现上传yapi平台时的接口。
38.本发明下述实施例将结合附图，对本发明提供的一种接口文档的上传方法进行说明。
39.图2是根据本发明实施例的一种接口文档的上传方法的流程图。如图2所示，包括步骤s201～s204。
40.在步骤s201中，基于用户在编译平台对接口文档进行修改，得到目标接口文档。
41.本发明实施例中，所述intelij dea编译平台的预览界面的生成方法，包括：在目标代码编写完成的情况下，响应于监听到用户下发的插件指令，显示第一代码辅助功能界面，其中，所述第一代码辅助功能界面用于选择目标插件；显示第二代码辅助功能界面，其中，所述第二代码辅助功能界面用于选择所述目标插件的目标接口；整合所述目标接口的相关信息，自动生成接口文档预览界面。
42.其中，响应于监听到用户下发的插件指令，包括：当用户完成代码文件的编写后，通过鼠标右键点击所述代码文件的方法名或方法类名；响应于监听到鼠标右键触发第一代码辅助功能界面，选择目标插件；响应于监听到鼠标右键点击目标插件触发的第二代码辅助功能界面，选择与所述目标插件对应的目标接口。在本实施例中，方法名或方法类名确认目标代码文件的内容。
43.所述目标接口的相关信息，包括：所述目标接口的参数信息，其中，所述参数信息包括：输入参数和返回参数信息；基于目标代码文件中的javadoc注释和javaparser的解析，获取所述目标代码文件方法名或方法类名的数据信息。
44.其中，在开发人员提交的代码文件中确定目标代码文件，其中，该目标代码文件可能是一个也可能是多个，因此，在实际开发工作中，开发人员会关注接口的路径、动作、参数和返回值等信息，其中，这些接口信息是通过javadoc或者javaparser等方式的注释和分析来获取的。
45.其中，通过javadoc或者javaparser等方式获取接口类的相关信息的方法包括：通过对目标java代码文件进行遍历，确定接口类；对每个接口类的方法进行遍历，基于javadoc或者javaparser等方式的注解，确定带有动作注解的接口方法；针对每个接口方法，根据该接口方法的动作注解，确定该接口方法对应接口的接口动作和接口路径；根据该接口方法的javadoc注释，确定该接口方法对应接口的接口名称、接口描述及该接口方法的参数描述、返回值描述；对每个接口方法对应接口的接口动作、接口路径、接口名称、接口描述及每个接口方法的参数描述、返回值描述进行格式转换处理，获取所述目标代码文件方法名或方法类名的数据信息。
46.所述基于用户在intelij dea编译平台的预览界面对接口文档的自定义修改，得到目标接口文档，包括：调用intelij dea编译平台中的插件sequencediagram生成uml时序图；将所述uml时序图插入所述接口文档中，得到第一接口文档；根据接口管理平台对接口文档格式的要求，转化所述第一接口文档格式为目标格式，得到目标接口文档。
47.用户可以在intellij dea编译平台页面上根据实际需求对接口文档进行预览或自定义修改。响应于用户选择的是接口类，则用户可以在该接口类的接口中选择其中一个或几个进行修改。响应于用户选择的是单个接口，则用户可对该接口进行修改。
48.其中，调用intelij dea中的插件sequencediagram生成uml时序图的插件为编译平台已有插件，生成的时序图可以作为接口备注插入接口文档中。时序图(sequence diagram)，亦称为序列图、循序图或顺序图，是一种uml交互图。它通过描述对象之间发送消息的时间顺序显示多个对象之间的动态协作。时序图是一个二维图，横轴表示对象，纵轴表
示时间，消息在各对象之间横向传递，依照时间顺序纵向排列。本发明实施例中，在接口文档中插入时序图可以展示对象之间交互的顺序。将交互行为建模为消息传递，通过描述消息是如何在对象间发送和接收的来动态展示对象之间的交互；相对于其他uml图，时序图更强调交互的时间顺序；可以直观的描述并发进程。
49.本发明在intelij idea编译平台上完成对目标代码的编写，在编写完成的情况下，用户可以通过鼠标右键点击该目标代码的方法名或方法类名，获取插件选项界面；用户可以通过鼠标在该插件选项界面上选择目标插件，当用户通过鼠标右击目标插件选项时，获取目标插件的接口选项界面；用户只需在该接口选项界面上选择目标接口，intelij idea编译平台便可自动生成接口文档，这样大大减少了开发人员的编写时间，实现快速高效的生成接口文档，
50.在步骤s202中，在接口管理平台内对所述目标接口文档进行检索，响应于未检索到所述目标接口文档，则根据用户指定的地址链接上传所述接口文档至接口管理平台。
51.当intelij idea编译平台完成对目标代码文件自动生成接口文档后，本发明还提供了上传所述接口文档至接口管理平台的方法，其中，本发明所述接口管理平台包括yapi平台。所述接口文档的上传方法，还包括：将所述接口文档导出至本地markdown文件。
52.本发明实施例中，不同开发人员可以通过在不同终端设备上实现协同开发软件，其中，开发人员编写的代码可以保存在本地，也可以通过网络传输至服务器进行保存。
53.本实施例主要针对上传接口文档至yapi平台。在一种实施例中，所述在接口管理平台内对所述目标接口文档进行检索，还包括：响应于检索到所述目标接口文档，则对所述目标接口文档对应的接口进行更新。
54.在步骤s203中，响应于接收到用户发送的指定地址链接，则基于所述指定地址链接，上传所述目标接口文档至接口管理平台。
55.在步骤s204中，响应于未接收到用户发送的指定地址链接，则获取所述接口管理平台内的接口可用地址链接目录，基于用户选择的目标地址链接，上传所述目标接口文档至接口管理平台。
56.所述将所述接口文档上传至接口管理平台，包括：响应于接收到用户端发送的首次上传请求，则配置账户名和密码，并向接口管理平台发送验证请求；获取接口管理平台返回的登陆验证token；响应于接收到用户端发送的非首次上传所述接口文档至接口管理平台的上传请求，则根据提前配置好的账户名和密码自动登陆验证token；上传所述接口文档至接口管理平台，并返回所述接口文档的地址信息至用户端。
57.其中，当用户选择上传所述接口文档至接口管理平台时，需在intelij dea插件环境配置中配置所述接口管理平台的地址链接，以及用户账户密码；若所述地址链接在所述接口管理平台内存在，则更新所述接口文档；若所述地址链接在所述接口管理平台内不存在，则根据用户选择的地址返回所述接口文档。其中，当地址链接在接口管理平台内不存在时，接口管理平台将会显示所有可供配置的地址链接供用户选择，用户可以根据需求选择合适的地址连接进行配置。
58.在本发明实施例中，针对接口相关信息信息中的每个接口，可以先确定接口管理平台是否记录有该接口的相关信息。如果有，则进一步可以判断接口管理平台中记录的该接口的相关信息与接口相关信息信息中该接口的相关信息是否相同。如可以通过对比接口
管理平台中记录的该接口的相关信息的参数值与接口相关信息信息中该接口的相关信息的参数值是否相同来做判断。如果相同，则可以不执行更新操作，继续保留接口管理平台中记录的该接口的相关信息。如果不同，则可以使用接口相关信息信息中该接口的相关信息更新接口管理平台中记录的该接口的相关信息。如果没有，即接口管理平台中未记录有该接口的相关信息，则可以确定该接口为新增接口，可以执行数据插入操作，在接口管理平台中增加记录接口相关信息信息中该接口的相关信息。
59.针对接口管理平台中记录的变更接口类的每个接口，可以判断接口相关信息信息中是否存在该接口的相关信息，如果不存在，则可以认为该接口已经在代码文件中被删除，可以在接口管理平台中删除该接口的相关信息。
60.本发明实施例中，接口文档的上传应该根据开发人员需要修改相应格式进行上传，同时修改接口文档时也应将接口文档格式转换为相应格式进行上传。
61.在接口文档上传成功之后，将返回上传之后的url供用户查看，其中，在所述上传所述接口文档至接口管理平台后，返回所述接口文档的地址信息至用户端，包括：上传所述接口文档至接口管理平台，响应于上传成功，返回地址链接至用户端。
62.本发明实施例实现了从代码接口层面到实际yapi平台上接口文档之间的深度绑定，接口更新之后只需要重新上传就可以实现远程接口文档的自动更新，并且接口文档上传时只需一次配置便可免验证登录，从而简化了接口文档的生成办法，为开发人员提供了便利。
63.图3是根据本发明实施例的一种接口文档自动生成及上传过程的交互示意图。如图3所示，用户可以根据目标java文件类型在编译器上选择合适的方法类生成接口文档，其中，具体执行过程包括：基于用户选择的方法类，编译器可以根据用户选择的方法类，对接口进行解析，获取接口的相关信息；根据接口生成的相关信息，编译器可以生成接口文档；基于不同编译器对接口文档格式的要求，对接口文档格式进行转换，从而生成json格式yapi文档；调用编译器中已有插件sequencediagram生成接口时序图，作为接口备注插入接口文档中。返回该接口文档至用户端，用户端可以对该接口文档进行预览和修改。
64.接口文档的上传过程包括以下交互步骤：用户在编译器首页选择上传地址yapi平台接口分组，上传接口文档。编译器基于接收到的接口文档会在已有的yapi接口文档中进行检索，判断该接口文档是否已经存在于yapi平台内，若已存在，则返回原接口位置；若不存在，则编译器将会返回所有可供选择的接口位置，用户可以根据实际需要选择接口位置。在确定接口文档的上传位置上传接口文档时，需要将接口文档的格式修改为与编译器文档格式相同的格式。
65.上传接口文档至接口管理平台的过程包括以下交互步骤：编译器会根据用户名密码获取验证token；通过在接口管理平台登录验证token，可实现对接口文档的上传过程；将接口文档上传至接口管理平台的目标位置。
66.返回接口文档的过程包括以下交互步骤：将接口文档的目标位置地址链接返回至编译器；将该接口平台的地址连接返回至用户端可以实现用户对接口文档的查看。
67.实施例二
68.与前述方法的实施例相对应，本发明还提供了装置及其所应有的终端的实施例。
69.图4是根据本发明实施例的一种接口文档的上传装置的框图，如图4所示，该装置
400包括修改模块401，第一上传模块402，第二上传模块403和第三上传模块404。
70.修改模块401，被配置为基于用户在编译平台对接口文档进行修改，得到目标接口文档；
71.第一上传模块402，被配置为在接口管理平台内对所述目标接口文档进行检索，响应于未检索到所述目标接口文档，则根据用户指定的地址链接上传所述接口文档至接口管理平台；
72.第二上传模块403，被配置为响应于接收到用户发送的指定地址链接，则基于所述指定地址链接，上传所述目标接口文档至接口管理平台；
73.第三上传模块404，被配置为响应于未接收到用户发送的指定地址链接，则获取所述接口管理平台内的接口可用地址链接目录，基于用户选择的目标地址链接，上传所述目标接口文档至接口管理平台。
74.可选的，所述第一上传模块402用于在接口管理平台内对所述目标接口文档进行检索，还包括：响应于检索到所述目标接口文档，则对所述目标接口文档对应的接口进行更新。
75.可选的，所述修改模块401用于基于用户在intelij dea编译平台的预览界面对接口文档的自定义修改，得到目标接口文档，包括：调用intelij dea编译平台中的插件sequencediagram生成uml时序图；将所述uml时序图插入所述接口文档中，得到第一接口文档；根据接口管理平台对接口文档格式的要求，转化所述第一接口文档格式为目标格式，得到目标接口文档。
76.可选的，所述修改模块401用于intelij dea编译平台的预览界面的生成方法，包括：在目标代码编写完成的情况下，响应于监听到用户下发的插件指令，显示第一代码辅助功能界面，其中，所述第一代码辅助功能界面用于选择目标插件；显示第二代码辅助功能界面，其中，所述第二代码辅助功能界面用于选择所述目标插件的目标接口；整合所述目标接口的相关信息，自动生成接口文档预览界面。
77.可选的，所述修改模块401中目标接口的相关信息，包括：所述目标接口的参数信息，其中，所述参数信息包括：输入参数和返回参数信息；基于目标代码文件中的javadoc注释和javaparser的解析，获取所述接口数据信息。
78.可选的，所述第三上传模块404用于将所述接口文档上传至接口管理平台，包括：响应于接收到用户端发送的首次上传请求，则配置账户名和密码，并向接口管理平台发送验证请求；获取接口管理平台返回的登陆验证token；响应于接收到用户端发送的非首次上传所述接口文档至接口管理平台的上传请求，则根据提前配置好的账户名和密码自动登陆验证token；上传所述接口文档至接口管理平台，并返回所述接口文档的地址信息至用户端。
79.关于上述实施例中的装置，其中各个模块执行操作的具体方式已经在有关该方法的实施例中进行了详细描述，此处将不做详细阐述说明。
80.相应于上面的方法实施例，本发明实施例还提供了一种计算机可读存储介质，计算机可读存储介质上存储有计算机程序，计算机程序被处理器执行时实现上述接口文档生成方法的步骤。
81.本说明书中各个实施例采用递进的方式描述，每个实施例重点说明的都是与其它
实施例的不同之处，各个实施例之间相同或相似部分互相参见即可。
82.专业人员还可以进一步意识到，结合本文中所公开的实施例描述的各示例的单元及算法步骤，能够以电子硬件、计算机软件或者二者的结合来实现，为了清楚地说明硬件和软件的可互换性，在上述说明中已经按照功能一般性地描述了各示例的组成及步骤。这些功能究竟以硬件还是软件方式来执行，取决于技术方案的特定应用和设计约束条件。专业技术人员可以对每个特定的应用来使用不同方法来实现所描述的功能，但是这种实现不应认为超出本发明的范围。
83.图5是根据本发明实施例的一种电子设备装置的框图，如图5所示，所述电子设备包括存储器、处理器、摄像头模组，所述存储器用于存储可在处理器上运行的计算机指令，所述处理器用于在执行所述计算机指令时实现本发明任一实施方式所述的接口文档的上传方法本发明至少一个实施例还提出了一种计算机可读存储介质，其上存储有计算机程序，所述程序被处理器执行时实现本发明任一所述的接口文档的上传方法本领域技术人员应明白，本发明一个或多个实施例可提供为方法、系统或计算机程序产品。因此，本发明一个或多个实施例可采用完全硬件实施例、完全软件实施例或结合软件和硬件方面的实施例的形式。而且，本发明一个或多个实施例可采用在一个或多个其中包含有计算机可用程序代码的计算机可用存储介质(包括但不限于磁盘存储器、cd-rom、光学存储器等)上实施的计算机程序产品的形式。
84.本发明中的“和/或”表示至少具有两者中的其中一个，例如，“a和/或b”包括三种方案：a、b、以及“a和b”。
85.本发明中的各个实施例均采用递进的方式描述，各个实施例之间相同相似的部分互相参见即可，每个实施例重点说明的都是与其他实施例的不同之处。尤其，对于用于接口文档的上传设备实施例而言，由于其基本相似于方法实施例，所以描述的比较简单，相关之处参见方法实施例的部分说明即可。
86.上述对本发明特定实施例进行了描述。其它实施例在所附权利要求书的范围内。在一些情况下，在权利要求书中记载的行为或步骤可以按照不同于实施例中的顺序来执行并且仍然可以实现期望的结果。另外，在附图中描绘的过程不一定要求示出的特定顺序或者连续顺序才能实现期望的结果。在某些实施方式中，多任务处理和并行处理也是可以的或者可能是有利的。
87.本发明描述的方法可以应用于智慧家庭(smart home)、智能家居、智能家用设备生态、智慧住宅(intelligence house)生态等全屋智能数字化控制应用场景。上述网络可以包括但不限于以下至少之一：有线网络，无线网络。上述有线网络可以包括但不限于以下至少之一：广域网，城域网，局域网，上述无线网络可以包括但不限于以下至少之一：wifi(wireless fidelity，无线保真)，蓝牙。终端设可以并不限定于为pc、手机、平板电脑、智能空调、智能烟机、智能冰箱、智能烤箱、智能炉灶、智能洗衣机、智能热水器、智能洗涤设备、智能洗碗机、智能投影设备、智能电视、智能晾衣架、智能窗帘、智能影音、智能插座、智能音响、智能音箱、智能新风设备、智能厨卫设备、智能卫浴设备、智能扫地机器人、智能擦窗机器人、智能拖地机器人、智能空气净化设备、智能蒸箱、智能微波炉、智能厨宝、智能净化器、智能饮水机、智能门锁等。
88.本发明中描述的主题及功能操作的实施例可以在以下中实现：数字电子电路、有
形体现的计算机软件或固件、包括本发明中公开的结构及其结构性等同物的计算机硬件、或者它们中的一个或多个的组合。本发明中描述的主题的实施例可以实现为一个或多个计算机程序，即编码在有形非暂时性程序载体上以被用于接口文档的上传装置执行或控制用于接口文档的上传装置的操作的计算机程序指令中的一个或多个模块。可替代地或附加地，程序指令可以被编码在人工生成的传播信号上，例如机器生成的电、光或电磁信号，该信号被生成以将信息编码并传输到合适的接收机装置以由用于接口文档的上传装置执行。计算机存储介质可以是机器可读存储设备、机器可读存储基板、随机或串行存取存储器设备、或它们中的一个或多个的组合。
89.本发明中描述的处理及逻辑流程可以由执行一个或多个计算机程序的一个或多个可编程计算机执行，以通过根据输入数据进行操作并生成输出来执行相应的功能。所述处理及逻辑流程还可以由专用逻辑电路—例如fpga(现场可编程门阵列)或asic(专用集成电路)来执行，并且装置也可以实现为专用逻辑电路。
90.适合用于执行计算机程序的计算机包括，例如通用和/或专用微处理器，或任何其他类型的中央处理单元。通常，中央处理单元将从只读存储器和/或随机存取存储器接收指令和数据。计算机的基本组件包括用于实施或执行指令的中央处理单元以及用于存储指令和数据的一个或多个存储器设备。通常，计算机还将包括用于存储数据的一个或多个大容量存储设备，例如磁盘、磁光盘或光盘等，或者计算机将可操作地与此大容量存储设备耦接以从其接收数据或向其传送数据，抑或两种情况兼而有之。然而，计算机不是必须具有这样的设备。此外，计算机可以嵌入在另一设备中，例如移动电话、个人数字助理(pda)、移动音频或视频播放器、游戏操纵台、全球定位系统(gps)接收机、或例如通用串行总线(usb)闪存驱动器的便携式存储设备，仅举几例。
91.适合于存储计算机程序指令和数据的计算机可读介质包括所有形式的非易失性存储器、媒介和存储器设备，例如包括半导体存储器设备(例如eprom、eeprom和闪存设备)、磁盘(例如内部硬盘或可移动盘)、磁光盘以及cd rom和dvd-rom盘。处理器和存储器可由专用逻辑电路补充或并入专用逻辑电路中。
92.虽然本发明包含许多具体实施细节，但是这些不应被解释为限制任何发明的范围或所要求保护的范围，而是主要用于描述特定发明的具体实施例的特征。本发明内在多个实施例中描述的某些特征也可以在单个实施例中被组合实施。另一方面，在单个实施例中描述的各种特征也可以在多个实施例中分开实施或以任何合适的子组合来实施。此外，虽然特征可以如上所述在某些组合中起作用并且甚至最初如此要求保护，但是来自所要求保护的组合中的一个或多个特征在一些情况下可以从该组合中去除，并且所要求保护的组合可以指向子组合或子组合的变型。
93.类似地，虽然在附图中以特定顺序描绘了操作，但是这不应被理解为要求这些操作以所示的特定顺序执行或顺次执行、或者要求所有例示的操作被执行，以实现期望的结果。在某些情况下，多任务和并行处理可能是有利的。此外，上述实施例中的各种系统模块和组件的分离不应被理解为在所有实施例中均需要这样的分离，并且应当理解，所描述的程序组件和系统通常可以一起集成在单个软件产品中，或者封装成多个软件产品。
94.由此，主题的特定实施例已被描述。其他实施例在所附权利要求书的范围以内。在某些情况下，权利要求书中记载的动作可以以不同的顺序执行并且仍实现期望的结果。此
外，附图中描绘的处理并非必需所示的特定顺序或顺次顺序，以实现期望的结果。在某些实现中，多任务和并行处理可能是有利的。
95.以上所述仅是本发明的较佳实施例而已，并非对本发明作任何形式上的限制，虽然本发明已以较佳实施例揭露如上，然而并非用以限定本发明，任何熟悉本专利的技术人员在不脱离本发明技术方案范围内，当可利用上述提示的技术内容作出些许更动或修饰为等同变化的等效实施例，上述实施例中的实施方案也可以进一步组合或者替换，但凡是未脱离本发明技术方案的内容，依据本发明的技术实质对以上实施例所作的任何简单修改、等同变化与修饰，均仍属于本发明方案的范围内。