接口应该从哪里起步，或者从哪里开始学？

Joe.xu

情况：

zf部门要求接口，提供一些数据，我还没研究到这步呢，但是这件事还挺着急。

请教大神们，做这个我应该看哪方面的资料，或者用哪个命令来实现。

文件内容：

(一) 接口说明

检测机构向特种设备综合管理平台中上传设备检验结果。

Action值为inspectResult。

(二) 请求业务参数

序号	名称	数据类型	必填项	描述
1	identity	varchar(50)	是	设备代码
2	checkCreditCode	varchar(32)	是	检验单位统一社会信用代码
3	deptCreditCode	varchar(32)	是	检验部门统一社会信用代码
4	reportCheckType	varchar(6)	是	报检类型
5	checkDiscoverType	varchar(1)	是	检验/检测类型 1: 检验 2: 检测
6	reportStatus	varchar(6)	是	当前流程状态(受理流程须填200)
7	reportSubmitTime	LocalDateTime	是	报检时间 (yyyy-MM-dd HH:mm:ss )
8	reportPer	varchar(32)	是	报检人
9	linkPer	varchar(32)	是	联系人
10	perPhone	varchar(32)	是	联系人电话
11	expectEndTime	LocalDateTime	否	期望检验检测完成时间
12	checkCategory	varchar(6)	否	检验类别(检验时选填, 检测时不填)
13	checkNature	varchar(6)	否	检验性质(1:正常检验 2:下达检验)
14	accept	varchar(32)	是	受理人
15	checkPerId	varchar(32)	是	核验员唯一识别码
16	checkPerName	varchar(32)	是	核验员名称
17	reportNum	varchar(32)	是	检验报告编号(唯一)
18	reportCheckDate	Date	是	报告审核日期
19	reportCheckPerId	varchar(32)	是	报告审核人唯一识别码
20	reportCheckPer	varchar(32)	是	报告审核人名称
21	reportAuthDate	LocalDate	是	批准日期
22	reportAuthPerId	varchar(32)	是	报告批准人唯一识别码
23	reportAuthPer	varchar(32)	是	报告批准人名称
24	checkDate	Date	是	检验日期
25	checkPeriod	varchar(6)	是	检测周期
26	periodUnit	varchar(6)	是	检测周期单位(年/月/日)
27	lastCheckDate	Date	否	上次检验日期
28	nextCheckDate	Date	是	下次检验日期
29	checkResult	varchar(6)	是	检验结论 (1_合格、2_不合格、3_复检合格、4_复检不合格)
30	insException	varchar(512)	否	设备问题(逗号分割)
31	manageException	varchar(512)	否	管理问题(逗号分割)
32	reportFile	varchar(128)	否	报告附件(附件上传返回的业务ID)
33	ReportCheckId	Varcher(32)	是	报检数据ID/编号

(三) 返回业务数据

(四) 示例

请求参数：

{

“version”:1,

“action”: “inspectSubmit”,

“data”: {

“identity”: “3430657602018300798712345678”,

“checkCreditCode”: “91430100694010560W”,

“deptCreditCode”: “91430100694010560W”,

“reportCheckType”: “1”,

“checkDiscoverType”:“1”,

“reportStatus”: “100”,

“reportSubmitTime”: “2020-12-22 19:04:48”,

“reportPer”: “张三”,

“linkPer”: “李四”,

“perPhone”: “18800000000”,

“expectEndTime”:“2020-12-23 19:04:48”,

“checkCategory”: “1”,

“checkNature”: “1”,

“accper”: “王五”,

“checkPerId”: “22cc79aaf6d61249806748f8a56fb8a7”,

“checkPerName”: “赵六”,

“reportNum”: “BGBH001”,

“reportCheckDate”: “2020-12-01”,

“reportCheckPerId”:“22cc79aaf6d61249806748f8a56fb8a7”,

“reportCheckPer”: “张三”,

“reportAuthDate”: “2020-12-22”,

“reportAuthPerId”: “22cc79aaf6d61249806748f8a56fb8a7”,

“reportAuthPer”: “张三”,

“checkDate”: “2020-12-2”,

“checkPeriod”:“1”,

“periodUnit”: “年”,

“lastCheckDate”: “2019-12-23”,

“nextCheckDate”: “2021-12-23”,

“checkResult”: “1”,

“insException”: “设备问题1,设备问题2,设备问题3”,

“manageException”: “管理问题1,管理问题2,管理问题3”,

“reportFile”: “http://127.0.0.1:8080/xx/xx.pdf”

}

返回数据：

{

“code”: 200,

“success”: true,

“msg”: “操作成功”

“data”: ‘’

}

1.1.1.1 报告附件上传

(一) 接口说明

上传检验/检测报告附件pdf文件.

https://host/external/api/upload POST方式

(二) 请求参数

file文件路径

名称	数据类型	是否必选	描述
file	File	是	报告文件

(三) 返回业务数据

名称	数据类型	描述
code	integer	状态码
success	boolean	是否成功(true成功 false失败)
data	String	文件编号ID
msg	String	返回消息

(四) 示例

1.2状态码定义

状态码	含义
200	操作成功
400	错误请求
401	请求未授权
403	请求被拒绝
404	未找到请求地址
420	授权令牌失效，请重新登录
421	请求的接口未授权
422	调用太频繁
423	接口名称代码或版本号错误
424	设备注册代码无效
425	设备名称错误
426	出厂编号为空
500	服务器内部错误

430	日期格式错误
431	该接口没有被授权数据范围
432	报检类型或当前流程状态填写错误
433	检验/检测类型填写错误
434	文件不存在

检验/检测类型字段是否必填 1 2

流程状态统一传数字使用我们系统的状态码

当前流程状态 100 200300 是否必填

Joe.xu · Joe.xu

您好，看了一下您的需求，理解应该是分为两部分
（1）提供接口，把数据提供给外部，这部分可以看下我们的服务端命令的介绍（大概从47分钟开始看，会有接口调用的示例）：
【已结束】活字格6.0 Update1 新版本功能
https://gcdn.grapecity.com.cn/forum.php?mod=viewthread&tid=82847&fromuid=60953
(出处: 葡萄城产品技术社区)
（2）调用外部接口获取数据，这个需要使用完我们的这边的免费插件，发送Http请求（点击查看），下面有使用教程教程希望能帮到您

huozige666 · huozige666

6.0 Update1是不是就是6.0.104?

Timothy.Xu · Timothy.Xu

huozige666 发表于 2021-2-26 09:52
6.0 Update1是不是就是6.0.104?

是的，6.0.104.0是 6.0 Update1 最新的版本~

alexyui · alexyui

是发送http请求和josn的处理吧？

huozige666 · huozige666

alexyui 发表于 2021-2-26 10:18
是发送http请求和josn的处理吧？

对对对

Tracy.Liu · Tracy.Liu

		自动登录	找回密码
密码			立即注册

[已处理] 接口应该从哪里起步，或者从哪里开始学？

最佳答案

6 个回复

本帖子中包含更多资源

评分

评分

评分

活字格认证

活字格高级认证

微信认证勋章

讲师达人

悬赏达人

圣诞拼拼乐

元老葡萄