众趣获取带看经纪人列表
说明:
- 此接口由接入方提供,众趣方调用
- 以下接口说明中的所有内容,仅为众趣方推荐的方式。按照以下说明提供接口,可以在提供接口时完成此接口接入,不再需要额外的联调测试。如果不使用以下规则实现接口,则需要接入方先咨询众趣产品,约定开发联调时间。
- 接口验证规则请参考回调接口规则说明
- 呼叫方发起带看时,会拨打给指定的一个或者多个带看经纪人。实现此接口,来根据项目id返回指定的带看经纪人。
接口提供
接入方需要提供此接口地址,参照如下规则给到众趣方:
https://customer.com/test/api/get_agents/?app_id=xxx&app_secret=yyy
入参示例:
https://customer_host.com/api/get_agents/?project_id=ID00001&app_id=1345×tamp=1532059200000&sign=edb7a6c92c4284fb7e825d63e7258b95&request_id=877602611346546688
入参参数说明:
参数名 | 数据类型 | 是否必传 | 参数说明 |
---|---|---|---|
project_id | string | 是 | 项目ID,与作品绑定的唯一ID |
app_id | string | 是 | 校验用,参考回调接口规则 |
timestamp | string | 是 | 校验用,参考回调接口规则 |
sign | string | 是 | 校验用,参考回调接口规则 |
request_id | string | 是 | 校验用,参考回调接口规则callback_id字段 |
custom_params | string/object/array/... | 否 | 无特定含义, 可用于接入方完成自定义逻辑 |
* 区别于回调接口,此接口使用request_id而不是callback_id。这两个字段除字段名外,保持一致。 |
返回参数示例:
[
{
"agentId": "1448291745301000000",
"agentName": "刘宝",
"agentPhone": "18682300000"
},
{
"agentId": "1448176777690000000",
"agentName": "杜闵",
"agentPhone": "18612300000"
},
{
"agentId": "1448223729064000000",
"agentName": "方杰",
"agentPhone": "18827300000"
}
]