开发接口文档API文档模板

X X X项目接口文档版本控制信息

1获取所有字段

1.1获取所有字段

请求地址：/session/field/findAll

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！

","page":0,"pageSize":0,"returnObject":null,"returnValue":{"types":null,"villages":null,"companys":[{"iconColour":"", "iconSize":0,"iconStyle":"","id":4,"name":"XX"},{"iconColour":"","iconSize":0,"iconStyle":"","id":5,"name":"XX"},{"icon Colour":"","iconSize":0,"iconStyle":"","id":7,"name":"XX"}]},"totals":0}

2文件上传

2.1文件上传（ajax）

请求地址：/session/file/upload

请求参数

响应

请求例子：var formData = new FormData();

("file", [0]);

$.ajax({

url : routePath + "/session/file/upload",

type : 'POST',

data : formData,

processData : false,

contentType : false,

success : function(result) {

result = (result);

if == "10000"){

('上传成功！');

}

}

});

响应例子：returnValue里包含了 fileName和filePath

3字段管理-所属类型

3.1新增所属类型

请求地址：/session/fieldType/save

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"totals":0}

3.2修改所属类型

请求地址：/session/fieldType/update

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"totals":0}

3.3根据id获取所属类型

请求地址：/session/fieldType/getById

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":{"id":2,"name":"re"},"totals":0}

3.4获取所属类型列表

请求地址：/session/fieldType/selectAll

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnObject":null,"returnValue":[{"id":1,"name":"123"},{"id":6,"name":"145555"}],"totals": 2}

3.5删除所属类型（批量）

请求地址：/session/fieldType/deleteByIds

请求参数

响应

响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"totals":0}

API接口文档

API接口文档 最后更新日期：2013-05-16 一、添加域名接口 (6) 1、接口调用地址 (6) 2、传入参数 (6) 3、输出数据 (6) 二、删除域名接口 (7) 1、接口调用地址 (7) 2、传入参数 (7) 3、输出数据 (7) 三、添加用户接口 (8) 1、接口调用地址 (8) 2、传入参数 (8) 3、输出数据 (8) 四、获取用户信息接口 (9) 1、接口调用地址 (9) 2、传入参数 (9) 3、输出数据 (9) 五、搜索用户接口 (10) 1、接口调用地址 (10) 2、传入参数 (10) 3、输出数据 (10) 六、修改用户接口 (11) 1、接口调用地址 (11) 2、传入参数 (11) 3、输出数据 (12) 七、删除用户接口 (13) 1、接口调用地址 (13) 2、传入参数 (13) 3、输出数据 (13) 八、获取邮箱别名接口 (14) 1、接口调用地址 (14) 2、传入参数 (14) 3、输出数据 (14) 九、获取部门列表接口 (15) 1、接口调用地址 (15) 2、传入参数 (15) 3、输出数据 (15) 十、添加部门接口 (17) 1、接口调用地址 (17)

3、输出数据 (17) 十一、修改部门接口 (18) 1、接口调用地址 (18) 2、传入参数 (18) 3、输出数据 (18) 十二、删除部门接口 (19) 1、接口调用地址 (19) 2、传入参数 (19) 3、输出数据 (19) 十三、获取部门成员接口 (20) 1、接口调用地址 (20) 2、传入参数 (20) 3、输出数据 (20) 十四、添加部门成员接口 (21) 1、接口调用地址 (21) 2、传入参数 (21) 3、输出数据 (21) 十五、删除部门成员接口 (22) 1、接口调用地址 (22) 2、传入参数 (22) 3、输出数据 (22) 十六、添加别名接口 (23) 1、接口调用地址 (23) 2、传入参数 (23) 3、输出数据 (23) 十七、修改别名接口 (24) 1、接口调用地址 (24) 2、传入参数 (24) 3、输出数据 (24) 十八、删除别名接口 (25) 1、接口调用地址 (25) 2、传入参数 (25) 3、输出数据 (25) 十九、获取POP接收邮件接口 (26) 1、接口调用地址 (26) 2、传入参数 (26) 3、输出数据 (26) 二十、添加POP接收邮件接口 (27) 1、接口调用地址 (27) 2、传入参数 (27) 3、输出数据 (27) 二十一、修改POP接收邮件接口 (28) 1、接口调用地址 (28)

开发接口文档-API文档模板

XXX项目接口文档版本控制信息 获取所有字段 获取所有字段 请求地址：/session/field/findAll 请求参数 响应

请求例子：响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！ ","page":0,"pageSize":0,"returnObject":null,"returnValue":{"types":null,"villages":null,"companys":[{"iconColour":"","iconSize":0,"ico nStyle":"","id":4,"name":"XX"},{"iconColour":"","iconSize":0,"iconStyle":"","id":5,"name":"XX"},{"iconColour":"","iconSize":0,"iconSty le":"","id":7,"name":"XX"}]},"totals":0} 文件上传 文件上传（ajax） 请求地址：/session/file/upload 请求参数 响应 请求例子：var formData = new FormData(); ("file", [0]); $.ajax({ url : routePath + "/session/file/upload", type : 'POST', data : formData,

processData : false, contentType : false, success : function(result) { result = (result); if == "10000"){ ('上传成功！'); $("#editHeadPortrait").val } } }); 响应例子：returnValue里包含了 fileName和filePath 字段管理-所属类型 新增所属类型 请求地址：/session/fieldType/save 请求参数 响应 请求例子：响应例子：{"code":"10000","exception":null,"isSuccess":true,"message":"成功，系统处理正常！","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"totals":0}

软件开发文档模板

软件开发文档模板 1 可行性研究报告 可行性研究报告的编写目的是：说明该软件开发项目的实现在技术、经济和社会条件方面的可行性；评述为了合理地达到开发目标而可能先择的各种方案；说明论证所选定的方案。可行性研究报告的编写内容要求如下： 1.1 引言 1.1.1 编写目的 1.1.2 背景 1.1.3 定义 1.1.4 参考资料 1.2 可行性研究的前提 1.2.1 要求 1.2.2 目标 1.2.3 条件、假定和限制 1.2.4 进行可行性研究的方法 1.2.5 评价尺度 1.3 对现有系统的分析 1.3.1 数据流程和处理流程 1.3.2 工作负荷 1.3.3 费用开支 1.3.4 人员 1.3.5 设备 1.3.6 局限性 1.4 所建议的系统 1.4.1 对所建议系统的说明 1.4.2 数据流程各处理流程 1.4.3 改进之处 1.4.4 影响 1.4.4.1 对象设备的影响 1.4.4.2 对软件的影响 1.4.4.3 对用户单位机构的影响 1.4.4.4 对系统动行的影响 1.4.4.5 对开发的影响 1.4.4.6 对地点和设施的影响 1.4.4.7 对经费开支的影响 1.4.5 局限性 1.4.6 技术条件方面的可行性 1.5 可选择其他系统方案 1.5.1 可选择的系统方案 1 1.5.2 可选择的系统方案 2 …… 1.6 投资及收益分析 1.6.1 支出 1.6.1.1 基本建设投资

1.6.1.2 其他一次性支出 1.6.1.3 非一次性支出 1.6.2 收益 1.6. 2.1 一次性收益 1.6. 2.2 非一次性收益 1.6. 2.3 不可定量的收益 1.6.3 收益/投资比 1.6.4 投资回收周期 1.6.5 敏感性分析 1.7 社会条件方面的可行性 1.7.1 法律方面的可行性 1.7.2 使用方面的可行性 1.8 结论 2 项目开发计划 编制项目开发计划的目的是用文件的形式，把对于在开发过程中各项工作的负责人员、开发进度所需经费预算、所需软、硬件条件等问题作出安排记载下来，以便根据本计划开展和检查本项目的开发工作。编制内容要求如下： 2.1 引言 2.1.1 编写目的 2.1.2 背景 2.1.3 定义 2.1.4 参考资料 2.2 项目概述 2.2.1 工作内容 2.2.2 主要参加人员 2.2.3 产品及成果 2.2. 3.1 程序 2.2. 3.2 文件 2.2. 3.3 服务 2.2. 3.4 非移交产品 2.2.4 验收标准 2.2.5 完成项目的最迟期限 2.2.6 本计划的审查者与批准者 2.3 实施总计划 2.3.1 工作任务的分解 2.3.2 接口人员 2.3.3 进度 2.3.4 预算 2.3.5 关键问题 2.4 支持条件 2.4.1 计算机系统支持 2.4.2 需要用户承担的工作 2.4.3 需由外单位提供的条件 2.5 专题计划要点

API 接口 设计文档 模板

Dream调试工具DLL接口文档 文件状态：[√] 草稿[ ] 正式发布[ ] 正在修改当前版本： 1.0 作者：ChunFeng Li 文件密级：[ ]普通[√]秘密[ ]绝密 文档版本 版本/状态作者参与者日期说明 1.0 ChunFeng Li ChunFeng Li 2016-04-13 设备只能发现串口连接的设备，指 令只能下发单条修改 一、DLL初始化 1.描述 调用所有接口之前需要先调用初始化接口。 2.接口名（dll导出名） Dream_Init() 3.请求参数说明 参数字段必选类型限制说明 _net_point True int<65535 Udp广播端口号 _com_rate True int 38400 连接串口的默认波特率 _call_back True Void* ... 异步消息回调（详细见第五条：回调函数） 4.返回参数说明 a.返回类型Int :0成功-1重复初始化 二、获取最新设备列表 1.描述 调用该接口获取所有当前在线列表。 2.接口名（dll导出名） Dream_GetDeviceList() 3.请求参数说明

char_buf True char* 1024 存放返回数据的内存指针，空间大小有调 用方分配 buf_len True int 1024 分配的空间大小 4.返回参数说明 a.返回类型Int : 返回数据长度。 b.返回数据结构:”1000,COM3\r\n1001,COM5\r\n1002,192.168.0.118\r\n”。 [ID,Name\r\n]为一个设备，以后有跟多设备详细信息，往后接。 三、发送指令消息 1.描述 下发数据和读取数据指令都通过该接口实现。(阻塞方式调用函数) 2.接口名（dll导出名） Dream_SendAction() 3.请求参数说明 参数字段必选类型限制说明 device_id True int>1000 发送消息的设备ID例如1000 _ChannelCode True int 0-0xFF 通道编码：例如0x10 _FunctionCode True int 0-0xFF 功能编码，不同的编码对应不同的功能_FunctionNumber True int 0-0xFF 功能编号，标记当前编码对应不同的功能data_msg True char* 发送指令的data，没有数据为NULL，如 果是单个数据：12.1，如果是整组数据： 12.1,1,0,...... 按顺序逗号隔开的连续字符 time_out True int 20*N 接口调用超时时间，单位毫秒 out_buf True char* 存放返回数据的内存指针，空间大小有调 用方分配 buf_max_len True int 分配的空间大小 4.返回参数说明 a.返回类型Int : 返回数据长度。如果为0,表示超时或网络异常 b.返回的数据结构：如果是下发数据，返回的是成功和失 败；”ACK”,”NAK”,”NO_CMD”,”ERROR”,”TimeOut”,如果是读取数据，返回的是数据， 例如12.1，或数据组12.1,12.2,1,1.2..... 四、DLL初始化 1.描述 下发数据和读取数据指令都通过该接口实现。(非阻塞方式调用函数) 2.接口名（dll导出名） Dream_SendAction() 3.请求参数说明

软件开发设计文档模板

软件开发设计文档

文档管理信息表 主题在线考试系统 版本 1.0 内容基于web的在线考试系统 关键字MVC模式在线考试考生.题库管理 参考文档JSP实用教程（第二版）清华大学出版社（耿祥义.张跃平编著）创建时间2016/7/4 最新发布日期2016/7/6 目录 1 引言 (1) 1.1设计背景 (3) 1.2编写目的 (4) 1.3系统概述 (4) 2开发规划 (4) 2.1开发人员 (4) 2.2开发计划 (4) 2.3开发环境和工具 (5) 3开发设计 (6) 3.1 需求概述 (6) 3.2 软件结构 (7) 3.3基本设计描述 (9) 3.3.1系统总体逻辑结构图 (8) 3.3.2系统部署结构图 (9) 3.4主要界面描述.......................................................................................................错误！未定义书签。 3.4.1用户打开界面............................................................................... 错误！未定义书签。 3.4.2答题界面....................................................................................... 错误！未定义书签。 3.4.2结果显示界面............................................................................... 错误！未定义书签。 3.5模块列表................................................................................................................错误！未定义书签。4数据结构........................................................................................................ 错误！未定义书签。5模块设计. (13) 5.1JSP编辑模块.......................................................................................... 错误！未定义书签。

APP软件开发项目文档模板

1．引言 1．1 编写目的 ·阐明开发本软件的目的； 1．2 项目背景 ·标识待开发软件产品的名称、代码； ·列出本项目的任务提出者、项目负责人项目负责人、系统分析员、系统设计员、程序设计员、程序员、资料员以及与本项目开展工作直接有关的人员和用户； ·说明该软件产品与其他有关软件产品的相互关系。 1．3 术语说明 列出本文档中所用到的专门术语的定义和英文缩写词的原文。 1．4 参考资料（可有可无） 列举编写软件需求规格说明时所参考的资料，包括项目经核准的计划任务书、合 同、引用的标准和规范、项目开发计划、需求规格说明、使用实例文档，以及相关产品的软件需求规格说明。 在这里应该给出详细的信息，包括标题、作者、版本号、发表日期、出版单位或资料来源。 2．项目概述 2．1 待开发软件的一般描述 描述待开发软件的背景，所应达到的目标，以及市场前景等。 2．2 待开发软件的功能 简述待开发软件所具有的主要功能。为了帮助每个读者易于理解，可以使用列表或图形的方法进行描述。使用图形表示，可以采用： ·顶层数据流图； ·用例UseCase图； ·系统流程图； ·层次方框图。

2．3 用户特征和水平（是哪类人使用） 描述最终用户应具有的受教育水平、工作经验及技术专长。 2．4 运行环境 描述软件的运行环境，包括硬件平台、硬件要求、操作系统和版本，以及其他的软件或与其共存的应用程序等。 2．5 条件与限制 给出影响开发人员在设计软件时的约束条款，例如： ·必须使用或避免使用的特定技术、工具、编程语言和数据库； ·硬件限制； ·所要求的开发规范或标准。 3．功能需求 3．1 功能划分 列举出所开发的软件能实现的全部功能，可采用文字、图表或数学公式等多种方法进行描述。 3．2 功能描述 对各个功能进行详细的描述。 4．外部接口需求 4．1 用户界面 对用户希望该软件所具有的界面特征进行描述。以下是可能要包括的一些特征： ·将要采用的图形用户界面标准或产品系列的风格； ·屏幕布局； ·菜单布局； ·输入输出格式； ·错误信息显示格式； 建议采用RAD开发工具，比如Visio，构造用户界面。

开发文档模板

XX系统开发 开发团队： 组长： 组员： 备注：广州大学华软软件学院 目录 XX系统开发 (1) 1 概述 (3) 1.1 开发背景 (3) 1.2 开发目标 (3) 1.3 参考资料 (3) 1.4 设计原则 (3) 2 需求分析 (3) 2.1 需求陈述 (3) 2.2 操作用例 (4) 2.3 功能分析划分 (4) 2.3.1 系统登录 (4) 2.3.2 用户管理 (4) (4) 2.5 运行环境 (4) 3 总体设计 (4) 3.1 系统建模 (4)

3.1.1 层次方框图 (4) 3.1.2 ER图（实体-联系图） (4) 3.1.3 类图设计 (5) 3.2 接口设计 (5) 3.2.1 内部接口设计 (5) 3.2.2 登录界面设计 (5) 3.2.3 用户管理界面设计 (5) (5) 3.3 数据库结构设计 (5) 3.3.1 数据库E-R图 (5) 3.3.2 数据库逻辑设计 (5) 2.5 出错处理 (5) 2.6 安全保密设计 (6) 4 详细设计 (6) 4.1 程序流程图 (6) 4.2 伪代码编写 (6) 5 实现 (7) 5.1 编码 (7) 5.1.1 代码约定 (7) 5.1.2 代码编写原则 (7) 5.2 测试要点 (7) 5.2.1 登录测试要点 (7) 5.2.2 主界面测试要点 (7) (7) 5.3 测试结果和总结 (7) 6 维护 (7)

6.1 维护方法 (7) 6.2 维护文档 (7) 6.3 功能拓展方法 (7) 1 概述 1.1 开发背景 【比如为什么要开发这个系统】 1.2 开发目标 【该系统需要完成的基本功能，对系统的大体描述】 1.3 参考资料 【该系统涉及的开源项目等】 1.4 设计原则 【设计该系统遵守的原则，比如支持多数据库，可移植行，可拓展性等】 2 需求分析 2.1 需求陈述 【用平常语言描述该系统的全部功能和细节】

软件项目开发各阶段文档模板(参考)

目录 1. 范围 (1) 2. 总体要求 (1) 2.1总体功能要求 (1) 2.2软件开发平台要求 (1) 2.3软件项目的开发实施过程管理要求 (2) 2.3.1 软件项目实施过程总体要求 (2) 2.3.2 软件项目实施变更要求 (2) 2.3.3 软件项目实施里程碑控制 (3) 3. 软件开发 (4) 3.1软件的需求分析 (4) 3.1.1 需求分析 (4) 3.1.2 需求分析报告的编制者 (5) 3.1.3 需求报告评审 (5) 3.1.4 需求报告格式 (5) 3.2软件的概要设计 (5) 3.2.1 概要设计 (5) 3.2.2 编写概要设计的要求 (6) 3.2.3 概要设计报告的编写者 (6) 3.2.4 概要设计和需求分析、详细设计之间的关系和区别 (6) 3.2.5 概要设计的评审 (6) 3.2.6 概要设计格式 (6) 3.3软件的详细设计 (7) 3.3.1 详细设计 (7) 3.3.2 特例 (7) 3.3.3 详细设计的要求 (7) 3.3.4 数据库设计 (7) 3.3.5 详细设计的评审 (7) 3.3.6 详细设计格式 (8) 3.4软件的编码 (8) 3.4.1 软件编码 (8) 3.4.2 软件编码的要求 (8) 3.4.3 编码的评审 (8) 3.4.4 编程规范及要求 (8) 3.5软件的测试 (9) 3.5.1 软件测试 (9) 3.5.2 测试计划 (9)

3.6.1 交付清单 (9) 3.7软件的鉴定验收 (10) 3.7.1 软件的鉴定验收 (10) 3.7.2 验收人员 (10) 3.7.3 验收具体内容 (10) 3.7.4 软件验收测试大纲 (11) 3.8培训 (11) 3.8.1 系统应用培训 (11) 3.8.2 系统管理的培训（可选） (11) 1. 引言 (19) 1.1编写目的 (19) 1.2项目风险 (19) 1.3文档约定 (19) 1.4预期读者和阅读建议 (20) 1.5产品范围 (20) 1.6参考文献 (20) 2. 综合描述 (21) 2.1产品的状况 (21) 2.2产品的功能 (22) 2.3用户类和特性 (22) 2.4运行环境 (22) 2.5设计和实现上的限制 (23) 2.6假设和约束(依赖) (23) 3. 外部接口需求 (24) 3.1用户界面 (24) 3.2硬件接口 (25) 3.3软件接口 (25) 3.4通讯接口 (26) 4. 系统功能需求 (26) 4.1说明和优先级 (27) 4.2激励／响应序列 (27) 4.3输入／输出数据 (28) 5. 其它非功能需求 (28) 5.1性能需求 (28) 5.2安全措施需求 (29) 5.3安全性需求 (29) 5.4软件质量属性 (29) 5.5业务规则 (29) 5.6用户文档 (30)

京东API接口整理

1、类目API 获取商家类目信息 获取类目属性 通过类目属性ID获取属性值列表 设置商家级别的类目销售属性值 添加商家商品销售属性 更新商家商品销售属性 获取类目属性列表 获取类目属性值 获取单个类目信息 查找子类目列表 查询商家已授权的品牌 数据结构 item_cat categoryAttr类目属性对象 attrFeature类目属性特殊属性 categoryAttrGroup属性分组 attrGroupFeature属性分组特殊属性 categoryAttrValue类目属性值对象 attrValueFeature类目属性特殊属性 feature特殊属性 wareaddvender_sellsku添加商家商品销售属性

wareupdatevender_sellsku更新商家商品销售属性 brandList商家品牌List集合 2、店铺API 京东店铺API，包含提供商家、商家店铺基本信息及店内分类操作查询等功能。 添加卖家自定义店内分类 更新商家自定义店内分类 删除商家自定义店内分类 获取前台展示的商家自定义店内分类 查询商家基本信息 店铺信息查询 查询退货地址列表 查询发货地址列表 3、商品API 提供网站商品信息更新、查询API,该组下所有接口均不支持自营店铺业务 1. 新增商品 修改商品 商品上架 商品下架 删除商品信息 根据商品ID查询单个商品的详细信息 批量获取商品信息 检索商品信息

获取商品上架的商品信息 获取商品下架的商品信息 根据商品Id，销售属性值Id查询图片根据商品Id，销售属性值Id增加图片根据商品Id，销售属性值Id删除图片根据商品Id，销售属性值Id设置图片根据商品Id，检索商品图片 设置商品限购区域 查询商品限购区域 添加商品关联版式 修改商品关联版式 删除商品关联版式 查询关联版式id以及名称 查询关联版式详情 设置关联版式到商品 增加SKU信息 修改SKU信息 修改SKU库存信息 修改SKU价格信息 删除SKU 信息 根据外部ID获取商品SKU 根据商品ID列表获取商品SKU信息 获取单个SKU信息 回复商品评价 查询商品评价信息列表

软件架构设计文档模板

Software Architecture Document Version <1.0> Revision History Date Version Description Author < yyyy-mm-dd >