第三方应用可以直接通过调用该接口,获取获取客户信息 (==注意使用V2.0授权方式==)
正式:https://zenith.fdcyun.com/v20/api/pub/patrol/get-tenants.svc
测试:https://planet-test.fdcyun.com/v20/api/pub/patrol/get-tenants.svc
x-token:xxxxx //调用服务云[认证接口]得到的token,未传输此头的请求无法获取数据
x-custid:xxxx //客户主数据GUID(SaaS产品认证不需要该项)
Content-Type: application/json; charset=utf-8
{
"page": 1,
"size": 10,
"keyword":"城投", //模糊匹配kh_sortname
"tag_name":"千亿" //过滤tag_name
}
成功返回,http状态码为 200
{
"total": 1,
"items": [
{
"area": "陕西公司", //区域
"tenant_id": "my561f78c61816f", //租户Id
"tenant_name": "延安城投", //租户名称
"khguid": "ba599913-2dee-439a-94eb-006e48b8702e", //客户guid
"kh_sortname": "陕西汇景置业有限公司", //客户短名称
"tag_name": "TOP10,测试标签1,头部客户,千亿客户", //客户类型标记
"type": "千亿", //客户类型(千亿、头部、拓新)
"operation_status": "维护中", //运维状态
"fw_duty_guid": "35edcb77-819b-40a9-9dec-cbb5f00c945c", //服务负责人 guid
"fw_duty_name": "熊建斌", //服务负责人
"cs_duty_guid": "0f44e23d-3d08-408c-b9b9-5758cb82f991", //400 负责人 guid
"cs_duty_name": "朱冰" //400 负责人 nam
}
]
}
调用异常时返回http状态码为4xx或者5xx时为异
服务端错误(500)时的内容格式如下
{
"Message": "xxx",
"ExceptionType":"xxx"
}
http状态码 | 说明 |
---|---|
200 | 表示请求成功 |
403 | 未授权 |
404 | 路径不对 |
500 | 参数不正确或其他服务端异常 |