接口文档

[TOC]

概述

线索同步接口是由对接平台的开发者提供相关HTTPS接口。在平台有新的线索记录产生的时候,通过接口用POST的方式将线索的相关信息传输给开发者服务器,开发者通过接口接收数据,数据接收成功后应立即返回处理结果。

接口说明

接口URL:

测试环境:

生产环境:

访问方式:

POST

请求数据格式:

header参数 Content-Type:application/json

请求参数:key->value形式

接口参数说明

名称 类型 必选 默认值 描述
activityid String 活动id
uniqid String 线索唯一id
phone String 线索
timestamp String 1970-01-01开始的时间戳,毫秒为单位。
sign String 参数签名,sign需要进行md5加密在进行传参
url String 新建广告时添加的url
activityUrl String 页面链接:用于监控页面上多个链接

sign参数说明:
md5(uniqid | phone | timestamp) 并且截取字符串9-24位;

成功响应数据格式:

1
2
3
4
5
6
7
{
"success": true,
"message": "",
"msgCode": "",
"model": null,
"attributes": null
}

失败响应数据格式:

1
2
3
4
5
6
7
{
"success": false,
"message": "参数校验失败",
"msgCode": null,
"model": null,
"attributes": null
}
1
2
3
4
5
6
7
{
"success": false,
"message": "线索数据同步异常",
"msgCode": null,
"model": null,
"attributes": null
}

测试数据样例:

1
2
3
4
5
6
7
8
9
{
"activityid": "1111",
"uniqid": "1",
"phone": "1234567890",
"timestamp": "2019-6-18 16:58:37",
"sign": "591cd07103f201c2",
"url": "www.baidu.com",
"activityUrl": "www.baidu.com"
}