官方活动获取API

¥收费高级接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/ActivityInfo

支持格式:json

请求方式:get

Session获取地址:http://api.tkurl.top/authorize?appkey=

请求示例:http://api.tkurl.top/api/alimama/ActivityInfo?appkey=&pid=mm_xxx_xxx_xxx&ActivityMaterialId=&session=

请求参数说明:

名称 类型 是否必须 示例值 描述
appkey String 必填 123456 appkey
session String 必填 授权后,再授权页面获取 。(有效期30天)
pid String 必填 mm_123_123_123 当前授权帐号下的PID,满足mm_xxx_xxx_xxx格式
ActivityMaterialId String 必填 123 活动推广中的"活动会场id"
RelationId String 可选 123 渠道关系id
UnionIid String 可选 demo 自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道

响应参数

名称 类型 示例值 描述
wx_qrcode_url String https://img.alicdn.com/xxx 【本地化】微信推广二维码地址
click_url String https://s.click.xx.xx/xxx?xx 推广长链接
short_click_url String https://s.click.xx.xx/xxx?xx 推广短链接
terminal_type String 2 投放平台:1-PC,2-无线
material_oss_url String http://xxx.xxx.xxx 物料素材下载地址
page_name String 活动会场A 会场名称
page_start_time String 2020-02-27 活动开始时间
page_end_time String 2020-02-27 活动结束时间
wx_miniprogram_path String pages/sharePid/web/index?scene=https://xxxx 【本地化】微信小程序推广地址

响应示例

 {
    "tbk_sc_activity_info_get_response":{
        "data":{
            "wx_qrcode_url":"https:\/\/img.alicdn.com\/xxx",
            "click_url":"https:\/\/s.click.xx.xx\/xxx?xx",
            "short_click_url":"https:\/\/s.click.xx.xx\/xxx?xx",
            "terminal_type":"1",
            "material_oss_url":"http:\/\/xxx.xxx.xxx",
            "page_name":"活动会场A",
            "page_start_time":"2020-02-27",
            "page_end_time":"2020-02-27",
            "wx_miniprogram_path":"pages\/sharePid\/web\/index?scene=https:\/\/xxxx"
        }
    }
}
   

异常示例

{
	"error_response":{
		"sub_msg":"非法参数",
		"code":50,
		"sub_code":"isv.invalid-parameter",
		"msg":"Remote service error"
	}
}
   

错误码解释

错误码 错误描述 解决方案
4 入参adzone_id不存在 查询不到对应的adzoneId,请检查adzoneId是否正确
isp.invalid-parameter-adzone 入参adzone_id错误 请检查adzone_id
isp.invalid-parameter-materialId 无效的物料id 请检查物料id是否从官方渠道获取
1108 【本地化】饿了么微信小程序二维码生成失败 请稍后重试,多次重试无效后请联系官方人员
isp.isp.get-activityinfo-unavailable 服务无法获取 请稍后重试,多次重试无效后请联系官方人员
1 服务系统异常 请稍后重试,多次重试无效后请联系官方人员
1107 【本地化】饿了么短链生成失败 请稍后重试,多次重试无效后请联系官方人员
isv.invalid-parameter-materialId 物料id错误 请检查物料id是否从官方渠道获取
602 调用次数超出
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确