# 4.3 服务商接口调试

为让开发者快速理解开发流程,本篇章以新增部门为例说明如何调试api接口。调用api的过程,本质上就是发送http请求给外勤365后台。在正式开发前,我们可以使用在线调试功能或者工具模拟http请求调试api。

# 在线调试api

外勤365提供了方便的在线调试功能在线调试 (opens new window)

如下图示,按照文档填写正确参数,在页面中发送post请求即可(红色箭头所指为需要注意的点)。如果新增成功,响应码return_code返回0。

avatar

# 使用工具调试api

这里以 postman 为例(下载地址 (opens new window),使用方法略),当然你也可以使用其它http模拟工具。

新增部门api见新增部门 (opens new window),可以看到其实就是一个post请求

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/organization/v1/addOrganization/{ openid }/{ timestamp }/{ digest }/{ msg_id }

post 参数为 openid、timestamp、digest、msg_id 和 消息体,参数含义参见业务接口格式规范 (opens new window)

1.设置Headers 如图所示,为Content-Type赋值application/json avatar

2.构造消息体 参考新增部门 (opens new window)

{
    "org_id":"ORG00001",
    "org_code":"waiqin00001",
    "org_name":"南京掌控网络",
    "org_parent_id":"",
    "waiqin365_parent_id":"",
    "org_sequence":20,
    "org_status":"1"
}

3.发送消息 如图所示,按照文档填写正确参数,在postman中发送post请求即可(红色箭头所指为需要注意的点)。如果新增成功,响应码return_code返回0