农业农村大数据采集数据接、数据表结构接口标准、码表列表.docxVIP

附录A采集数据接口标准

（规范性）

A.1接口协议

1）传输协议

Header头设置要求：Content-type:application/json;charset=utf-8

HTTP协议，JSON数据交换格式（鉴权消息除外）

2）采集第三方应用接口数据步骤：

鉴权接口（获取Token）?数据接口（调用数据）

A.2鉴权接口标准

采集软件调用第三方应用平台数据接口时，需首先调用此接口完成接入认证（获取Token）；认证过期后，需调用此接口重新进行认证，数据接口才能被继续访问。

A.3获取token接口

接口作用

鉴权认证，获取token

请求方法

GET

请求地址

http://IP地址/auth/getAccessToken（接口名称）

请求参数

参数

类型

示例值

描述

appId

String

BSL55HSL

第三方应用的身份标识，用于唯一标识一个应用key。

appSecret

String

5d42a91f082669cda6b310a3c80e6ec28176a08d

第三方应用的密钥，与appId对应的，用于登录访问第三方平台。

返回参数

参数

类型

示例值

描述

code

Integer

200

200=成功、403=验证失败（遵循HTTP响应状态码对照表）

message

String

成功

成功、失败

accessToken

String

713f76373d9a4289902873e0d1e16e06

鉴权参数（Token），访问数据接口的凭证。

A.4数据接口标准

接口作用

数据接口

请求方法

GET

请求地址

http://IP地址/getDataList/

请求参数

参数

类型

示例值

描述

accessToken

String

713f76373d9a4289902873e0d1e16e06

token

pageNum

Integer

2

当前页码

pageSize

Integer

100

每页条数

返回参数

响应参数

类型

示例值

参数说明

code

Integer

200

200=成功、403=验证失败（遵循HTTP响应状态码对照表）

message

String

成功

成功、失败

data.content

list

{“id”：1,”name”:”张三，”age”：55}

返回具体数据结果参数

data.totalPages

Integer

484

总页数

data.totalSize

Integer

241992

总条数

data.currentPage

Integer

2

当前页码

A.5数据表结构接口标准

接口作用

数据接口

请求方法

GET

请求地址

http://IP地址/getDataStructure（接口名称）

请求参数

参数

类型

示例值

描述

accessToken

String

713f76373d9a4289902873e0d1e16e06

token

tableName

String

t_basic_district

表名称

返回参数

响应参数

类型

示例值

参数说明

code

Integer

200

200=成功、403=验证失败（遵循HTTP响应状态码对照表）

message

String

成功

成功、失败

data.content

list

{fieldName:areaCode,

nameDes:区划代码,

dataType:String,

primaryKey:是,

isNull:否,

des:区划编码，显示6位}

数据表结构说明：

fieldName：字段名称

nameDes：中文名称

dataType：数据类型

主键：是否主键项

isNull：是否必填项

des：备注说明

data.tableName

String

t_basic_district

表名称

data.tableDes

String

行政区划表

表中文名称

附录B农业信息资源编码类目代码表

（规范性附录）

表B农业信息资源类目代码

代码

一级类目

二级类目

三级类目

四级类目

10

基础数据

1001

农业农村空间地理数据

1001001

水域

1001002

交通

1001003

地形地貌

1001004

行政区

1001005

畜牧兽医

1001006

科技教育

1001007

渔业渔政

1001008

种植业

1001099

其他

1002

农业遥感信息

1002001

遥感影像资料

1002002

农业遥感产品

1002999

其他农业遥感信息

1003

农业农村自然资源

1003001

水资源

1003002

土地资源

1003002001

耕地

1003002002

园地

1003002003

草地

1003002004

设施农