查询部门批量结果¶
功能说明¶
查询批量操作的结果
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/getByBatchNumber
- 生产环境: https://openapi.guanaitong.com/getByBatchNumber
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
- 公有参数
发送请求是必须传入公共参数,详见公共参数
- 私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| batch_num | 是 | string | [1,100] | 批次号 |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,企业不填) |
请求示例¶
https://openapi.guanaitong.tech/getByBatchNumber?access_token=9a236d8bdc39800bbcf1ec2b4dc97f1d&
batch_num=USERDOOR_BATCH_SET_PM_5a1ab36bc6b0e99f8726e99461db0429
&sign=51c79b12c83ed9e8b87266d7bfcca88a212c1f96×tamp=1504153260
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误返回码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回部门信息 |
| data.batch_number | 批次号 |
| data.total_count | 批次数据总量 |
| data.success_count | 成功数 |
| data.failure_count | 失败数 |
| data.failures | 操作失败的数据及信息 |
| data.failures.service_data | 失败的数据 |
| data.failures.reason | 失败的原因 |
正确返回示例¶
{
"code": 0,
"data": {
"batch_number": "USERDOOR_BATCH_SET_PM_5a1ab36bc6b0e99f8726e99461db0429",
"total_count": 1,
"success_count": 1,
"failure_count": 0,
"failures": null
},
"msg": "OK"
}