API开放平台

TIP

# 附录六 服务商接口调试

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

# 在线调试api

勤策提供了方便的在线调试功能。

第一步：点击“在线调试”链接

avatar

第二步：按照api文档描述在调试页面填写正确参数，向勤策发送post请求即可。如果接口调用成功，响应码return_code返回值为0。其中：Openid和Appkey需要向客户经理申请获取。

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 avatar

← 常见问题 - FAQ →