标签：可读性 type 家电 协议 允许 pair service recycle wiki
一、接口调用
协议：HTTPS/GET
辅助参数：Content-Type: application/json; charset=utf-8
URI：//{domain}/service/v2/coverageArea?serviceId=1
请求参数：
|
索引
|
名称
|
类型
|
JSON
|
说明
|
|---|---|---|---|---|
| ServiceId | int | serviceId |
业务ID(允许为空)。维修，回收，清洗等分别是一个业务(service)。 4194305-服务订单，维修 4194307-服务订单，回收 4194306-服务订单，清洗 |
|
| CategoryId | long | cateid | 家电分类号（允许为空）。手机为12，其他家电类统一为15 | |
| AreaCode | long | arcode | 行政区划代码。允许为空，表示查询所有省的信息 |
说明：此接口为获取业务服务地区接口。
------------------------------------------------------------------------
添加不带serviceid的接口，增强可读性。
维修服务的覆盖区 URI://domain/repair/v1/coverageArea
回收服务的覆盖区 URI://domain/recycle/v1/coverageArea
清洗服务的覆盖区 URI://domain/clean/v1/coverageArea
----------------------------------------------------------------------
二、响应数据说明
| 索引 | 名称 | 类型 | JSON | 说明 |
| 1 | ResponseCode | int | rpco |
响应码。参见“公共数据”定义。 |
| 2 | ResponseMessage | String | msg | 响应消息。参见“公共数据”定义。 |
| 3 | Body | Object | body | 响应数据体。参见“公共数据”定义。 |
| A | CoverageArea | Object | area | 服务支持的地区，null表示该地区不支持 |
| A.a | AreaCode | long | arcode | 行政区划代码 |
| A.b | AreaName | String | arname | 地区名称 |
| A.c | ChildCoverageAreas | Array | chareas | 该地区下支持的子地区列表。null表示没有子地区。 |
| A.c.1 | AreaCode | long | arcode | 行政区划代码 |
| A.c.2 | AreaName | String | arname | 地区名称 |
三、响应样例
正常：
{
"rpco": 200,
"tsrp": 1477461338690,
"body": {
"area": {
"arcode": 110100,
"arname": "市辖区",
"chareas": [
{
"arcode": 110101,
"arname": "东城区"
},
{
"arcode": 110105,
"arname": "朝阳区"
},
{
"arcode": 110108,
"arname": "海淀区"
}
]
}
}
}
异常：
{
"rpco": 401,
"msg": ""
}
标签：可读性 type 家电 协议 允许 pair service recycle wiki
原文地址：http://www.cnblogs.com/han-ying/p/7155172.html
