API接口文档(简单版)

发布时间:2018-06-26 15:56:09   来源:文档文库   
字号:

XX接口文档V1.0

制作yibyli

说明包含有基本的API格式,带有大纲,目录页眉

目录

目录 2

1. 登陆 2

1.1 描述 2

1.2 请求地址 2

1.3 请求参数 2

1.4 返回数据 2

1.5 请求URL实例 2

1.6 返回数据实例 3

2. API名称 3

2.1 描述 3

2.2 请求地址 3

2.3 请求参数 3

2.4 返回数据 3

2.5 请求URL实例 3

2.6 返回数据实例 3

1. 登陆

1.1 描述

登陆的接口

1.2 请求地址

操作

login

协议

HTTP

方式

GET

ULR全径

请求URL地址的全称

1.3 请求参数

序号

参数

中文名称

必选

数据类型

长度

备注

1

para1

第一个参数

Y

String

20

这个API第一个参数

2

Para2

第二个参数

N

String

20

这个API的第个参数

1.4 返回数据

序号

返回值

中文名称

备注

1

code

请求状态码

200请求成功,400请求失败(参数有误,)

2

data

返回数据

数组,数组中可能有键值对

3

result

返回结果

0发送验证码成功,1失败

1.5 请求URL实例

http://www.baidu.com/login?name=xx&password=1010(例子并不可以使用)

1.6 返回数据实例

{

    "code":200,

    "data":[

        {

            "result":1

        }

    ]

}

2. API名称

2.1 描述

这个API是用来做什么的,以及注意点

2.2 请求地址

操作

操作名称

协议

HTTP

方式

GET

地址

请求URL地址的全称

2.3 请求参数

序号

参数

中文名称

必选

数据类型

长度

备注

1

para1

第一个参数

Y

String

20

这个API第一个参数

2

Para2

第二个参数

N

String

20

这个API的第个参数

2.4 返回数据

序号

返回值

中文名称

备注

1

code

请求状态码

200请求成功,400请求失败(参数有误,)

2

data

返回数据

数组,数组中可能有键值对

3

result

返回结果

0发送验证码成功,1失败

2.5 请求URL实例

http://www.baidu.com/test?name=xx&password=1010

2.6 返回数据实例

{

    "code":200,

    "data":[

        {

            "result":1

        }

    ]

}

本文来源:https://www.2haoxitong.net/k/doc/d7b7f85b65ce0508773213bf.html

《API接口文档(简单版).doc》
将本文的Word文档下载到电脑,方便收藏和打印
推荐度:
点击下载文档

文档为doc格式