Skip to content

获取待拍摄项目列表接口

接口说明

对接此功能请先和众趣产品进行详细沟通。

对接此功能后，app端在点击添加项目后会调用到这个接口，从接入方此接口获取待拍摄项目列表。

拍摄人可以在app上选择需要创建的项目。项目创建后会在众趣后台生成一个对应订单。

注意：如果创建项目的时候已经有相同房源id的订单（未被取消或者作废的），则无法创建项目。

即众趣这边需要保证同一时间订单的房源id是唯一的，来保证其他功能，如订单信息查询，订单状态变更等的正常使用。

实现步骤：

  1. 接入方参照本文档进行开发
  2. 接入方按照本文档中的格式，提供数据接收接口的地址到众趣
  3. 众趣方审核后开通此功能
  4. 开通后，每次模型取消，众趣后台将调用此接口提供给app使用

数据接收接口规则：

  1. 接口应该以类似以下格式给出
http://customer-host.com/callback/recive_model_data?app_id=xxxxx&app_secret=yyyyy

  1. app_id和app_secret这两个参数用于完成验签。验签的具体实现请看下文验签规则。

  2. 数据接收接口必须支持POST方法

  3. 数据接收接口必须能够处理Content-Type值为application/json;charset=utf-8的请求

  4. 业务数据将会以json的格式包含在POST请求体中

  5. 当数据接收接口响应的http status值为200时，视为接口调用成功。

验签规则：

  1. 使用提供的app_id和app_secret两个参数实现验签功能

  2. 众趣调用客户数据接收接口时，在url中添加timestamp和key以及app_id这三个参数完成校验。接口调用时，url中不会包含app_secret这个参数。

  3. timestamp参数为调用时的时间戳，单位为秒

  4. key参数为string类型，生成规则为MD5(app_id + timestamp + "s" + app_secret)

  5. 可以根据以下计算验证代码计算结果

``` app_id = "test_app_id" timestamp = "1623053298" app_secret = "test_app_secret" key = MD5(app_id + timestamp + "s" + app_secret) 则key的值为： 3c38699b311aa850a0a6f548f0bf5ebe

请求方式：

POST

入参示例：
{
  "username": "当前摄影师账号"
}
入参参数说明：
参数名 数据类型 是否必传 参数说明
username string 是 摄影师名称
响应字段说明：
字段名 含义描述 是否必填 数据类型 其他信息
code 响应状态码 是 int
msg 响应消息 否 str
data 数据列表 是 object [] item 类型: object
house_name 房屋名称 是 str
hid 房屋ID 是 str
remark 备注信息 是 str