首页 > 代码库 > 管家二期可用接口文档

管家二期可用接口文档

2024-10-23 14:09:39   209人阅读

一、接口调用

协议：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": ""
}

 

管家二期可用接口文档


联系
我们