android 开发 ------- 接口文档 规范

1 接口书写的格式:

1   用例图

2   流程图

3   具体的接口:

3.1请求的方式:

包括:

服务器地址 le.gxjinan.com/open/user.php?ac=login

请求方式 POST

编码格式 UTF-8

内容的格式 application/x-www-form-urlencoded

3.2 请求的参数:

例如:

参数 类型 是否必须
说明

user String
是 手机号,邮箱,用户名

3.2 响应信息:

请求方式 POST

编码格式 UTF-8

数据类型 Json 数据实体,包含msg对象。

内部包含的注册成功后用户的ID!

3.3 返回的数据:

返回的正确信息

整体的Json 数据,

详细的Json数据,

返回错误的信息

时间: 2024-10-22 09:04:08

android 开发 ------- 接口文档 规范的相关文章

Eclipse3.7中搭建Android开发环境文档教程和视频教程

1.下载Eclipse3.7,登录http://www.eclipse.org/downloads/,下载Eclipse Classic 3.7: 2.安装ADT插件:下载好Eclipse后解压,运行Eclipse,第一次运行会提示设置workspace:在菜单栏选择Help-Install New Software,在Work with栏输入http://dl-ssl.google.com/android/eclipse/并回车,稍后显示如下图: 选择Select All按钮,单击Next--

Android开发帮助文档Doc打开速度慢解决_Python篇

解决android帮助文档打开慢 网友说是因为Doc目录下的html文件里含有访问google的js文件 <link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Roboto:regular,medium,thin,italic,mediumitalic,bold" title="roboto"> 和 <script src="http:/

开发接口文档--本接口文档是读取控制器方法上的注释自动生成的

本文档是参考网上的然后根据公司需要对代码进行了抽取和优化(主要是加了标题栏和对输出进行了格式化输出,更换呢了页面渲染方式(改为直接使用php进行渲染,原来的是使用了模板引擎),可读性较好),配置简单,读取方便,和项目耦合性较小,只需要将api_view这个文件夹放到和项目同级就可以使用,接口文档只有100多k大小 1.配置控制器 按照上图格式写接口方法注释(主是在控制器上面和方法上) 2.将接口文档放置在和项目同级 注:上面3个事项目,最下面的是接口文档 3.配置接口文档配置文件 api_vie

后台接口文档示例

什么是接口文档? 在项目期间,前后端是分离开发的,为了前后有连贯性,就必须由前后开发工程师共同定义接口.写接口文档再根据接口文档去开发,一直到项目结束. 接口文档规范 方法 也就是我们常写的新增,删除,修改,查询 url 调用方法,一般是从前端调后端的方法地址 请求参数 一般分五列:字段.说明.类型.备注.是否必填 返回参数 1.如果只返回接口调用成功还是失败(新增.删除.修改等),则只有一个结构体: code和message两个参数: 2.如果要返回某些参数,则有两个结构体: 是code/me

常用接口文档模板

接口规范说起来大,其实也就那么几个部分,接口规范.接口管理工具.接口文档编写.开发文档编写.以下将详细介绍,下面进入正文: 接口规范文档 具体内容如下: 一:协议规范 二:域名规范 三:版本控制规范 四:API路径规范 五:API命名规范 六:请求参数规范 七:列表请求特殊规范 八:返回数据规范 九:接口文档规范 十:接口管理工具使用教程 参与编写 更新日期 版本 备注 AbyssKitty 2018/04/06 V1.1.0 无 V1.1.0更新日志: 1. 新增协议规范.域名规范.版本控制规

SpringBoot + Swagger2 自动生成API接口文档

spring-boot作为当前最为流行的Java web开发脚手架,相信越来越多的开发者会使用其来构建企业级的RESTFul API接口.这些接口不但会服务于传统的web端(b/s),也会服务于移动端.在实际开发过程中,这些接口还要提供给开发测试进行相关的白盒测试,那么势必存在如何在多人协作中共享和及时更新API开发接口文档的问题. 假如你已经对传统的wiki文档共享方式所带来的弊端深恶痛绝,那么尝试一下Swagger2 方式,一定会让你有不一样的开发体验: 功能丰富 :支持多种注解,自动生成接

app后端开发二:API接口文档工具

悲伤的历史 在进行app后端开发过程中,后端会提供出来很多的api接口供前端开发使用,为了让前端开发人员顺利使用,我们会写好一份文档,告诉他们这个接口你该用 GET 还是 POST 来访问,同时访问的时候该给我传递一些什么参数,以及正确的时候我会返回什么给你,已经返回的数据样式以及字段解释等等这些事情,我们都需要在文档中写好写清楚. 在 app后端开发一:基于swagger-ui构建api接口文档工具 这篇博客中,我写了 swagger-ui 的好处以及优势.但是在使用过程中,发现不够给力.我想

开发底层硬件应该怎么编写接口文档

开发底层硬件应该怎么编写接口文档 这几天在做超市RFID结算系统的上位机程序编写,用的是VB.NET.底层用的是别人开发好的SDK,为什么要写这一篇文章呢?最近因为手头设备的功能限制,我就在网上找其他的公司的RFID射频卡读写器,由于我是做上层开发,所以需要设备供应商提供底层SDK二次开发包,找了好多设备提供商 ,也跟他们索取各自提供的SDK,但总的来说,我还是觉得最先用的这个设备的厂家提供的SDK是最详细的,现在简单说明如下: 一.函数说明: 1.目录结构清晰: 2.函数返回值,参数用表格说明

如何正确规范写接口文档

前言 正规的团队合作或者是项目对接,接口文档是非常重要的,一般接口文档都是通过开发人员写的.一个工整的文档显得是非重要.下面我将我看到的一篇接口文档做一个总结 开始吧!!! 接口1: 查询排重接口 接口详情   地址 http://www.baidu.com (正式环境) 请求方式 GET 参数 是否必填 说明 idfa 是 广告标识符,只支持单个查询 source 是 渠道来源,具体值在接入时再进行分配 返回结果 格式 JSON 状态码 10000 success(调用成功)   10001