批量获取公司地址
(1)V1名称更新:“获取企业地点列表”改为“获取公司地址”
(2)新增“获取公司地址”V2接口
通过addressType查询对应类型的公司地址
有则返回
无则跳过,并报错
HTTP请求
POST https://api.mokahr.com/api-platform/locations/v2/get_location_list
请求body(json方式)
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
addressType | 是 | integer | 公司地址类型,必填 |
返回body的JSON数据如下:
字段 | 类型 | 描述 |
---|---|---|
code | integer | 错误码,非0表示失败 |
message | string | 错误描述 |
data | array | |
data[].addressId | string | 公司地址在Moka的唯一id |
data[].addressCode | string | 公司地址在外部系统的唯一id |
data[].country | string | 国家 |
data[].province | string | 省份 |
data[].city | string | 城市 |
data[].district | string | 县区 |
data[].address | string | 公司地址具体地点 |
data[].map | object | object |
data[].departments[].departmentName | string | 公司地址关联的部门名称 |
data[].departments[].departmentId | string | 部门在Moka的唯一id |
data[].departments[].departmentCode | string | 部门在外部系统的唯一id(需开启组织架构同步) |
请求样例
$ curl --location --request POST 'https://api.mokahr.com/api-platform/locations/v2/get_location_list' \
--header 'Content-Type: application/json' \
--header 'Authorization: ' \
--data-raw '{ "addressType": 0 }'
2
3
4
返回样例
{ "code":0, "message":"", "data":[{ "addressId":"", "addressCode":"", "country":"", "province":"", "city":"", "district":"", "address":"", "map":{}, "departments":[ { "departmentName":"", "departmentId":"", "departmentCode":"" } ] }] }