京推推首页
您好 ，请登录 免费注册
小工具 商家合作 开放平台API 帮助中心 联系我们
小程序
在线客服
我的收藏
帮助中心
官方采集群 在线客服
我的收藏 管理收藏夹
收起
商品文案 

				

				
			

		

	

	
	





    API基础说明
    系统参数
    请求参数
    返回参数
    返回示例
    
    






    

        API市场>
        基础功能API >创建推广位
    






 
 
创建推广位 （批量创建推广位） 免费
 
API类型: 基础功能API 使用人数:2900+
 
 槽点建议
 
API接口说明： 每个联盟ID最多创建5000个推广位。其中业务参数key需要由开发者进入联盟官网->我的工具->我的API->领取授权KEY中获取key。 
 
API使用建议： 
                            通过API批量创建的推广位将归类为开放平台推广位，此类推广位将不再于联盟PC官网后台显示，但是在效果报表-订单明细中可以显示推广位ID，会员可以通过开放平台API对推广位进行创建、查询、调用                        
 
应用场景： 帮助媒体批量创建多个推广位
 
 应用效果  免费接入  接口测试
 
槽点建议 
 
  
 
 
 
 
 
 
 上传图片
                                 
 
 
提交
 
 
 
 
 
 
API接口明细 API更新记录 错误参照代码
 

                            版本号：v2
                        

                            版本号：v1
                        
 
接口地址: http://japi.jingtuitui.com/api/new_positionid
 
请求数据: http://japi.jingtuitui.com/api/new_positionid?appid=&appkey=&v=&unionid=&key=&unionType=&type=&name=&siteId=
 
请求方式: GET / POST
 
支持格式: json / jsonp
 
系统参数 
 
名称 类型 必填 示例 说明
 
appid 
 复制
 Int 是 2010091553028980 您在京推推申请的appid
appkey 
 复制
 String 是 2 您在京推推申请的key
return_type 
 复制
 String 否 code_jsonp 返回数据格式，不传参默认json,支持以下参数code、jsonp、code_jsonp
 
请求参数说明 
 
名称 类型 必填 示例 说明
 
unionid 
 复制
 Long 
                                                是 
                                                    1002135924 
                                                联盟ID
key 
 复制
 String 
                                                是 
                                                    b57733a7028b090149977ea5e218c80314587eaf4afddc03572ed255e56f55a143bdaf04635af30e 
                                                京东联盟key。请在京东联盟->我的工具->我的API->领取授权KEY中获取key（联盟key有效日期为365天）
unionType 
 复制
 Int 
                                                是 
                                                    1 
                                                1cps推广位；2cpc推广位；3私域推广位，上限5000个，不在联盟后台展示，无对应 PID；4联盟后台推广位，上限500个，会在推客联盟后台展示，自动生成对应PID，可用于内容平台推广
type 
 复制
 Int 
                                                是 
                                                    1 
                                                站点类型 1网站推广位；2APP推广位；3社交媒体推广位；4聊天工具推广位；5二维码推广
name 
 复制
 String 
                                                是 
                                                    测试1 
                                                推广位名称集合，请用英文逗号进行分割，上限50个（开放平台创建的推广位在联盟官网不展示，最多可以创建5000个推广位）
siteId 
 复制
 Long 
                                                否 
                                                     
                                                站点ID：网站的ID/app ID/snsID ，当type非4(聊天工具)时，siteId必填
 
返回参数说明 
 
名称 类型 示例值 说明
 
code 
 复制
 Int 
                                                0 
                                                0=返回成功
result 
 复制
  
                                                 
                                                返回结果
> unionId 
 复制
 Long 
                                                1002135924 
                                                联盟ID
> position_list 
 复制
  
                                                 
                                                
>> name 
 复制
 String 
                                                测试01 
                                                推广位名称
>> positionid 
 复制
 Long 
                                                20000727267 
                                                推广位id，但是对应的pid不能作为母子分佣使用。
msg 
 复制
  
                                                 
                                                
 
JSON返回示例 
 


    {
        "code": "0",
        "result": {
            "unionId": "1000040937",
            "position_list": [
                {
                    "name": "测试1",
                    "positionid": 21000473333
                }
                {
                    "name": "测试2",
                    "positionid": 21000476666
                }
            ]
        },
        "msg": "ok~"
    }

 
v1.1版本 更新时间: 2020-09-21 18:25:48
 
 
v1.1更新内容

                                                        一、请求参数

1    增加推广位类型unionType

2    增加推广位站点类型type

3    增加站点IDsiteId返回

二、返回参数增加联盟类型返回type                        
 
错误码 说明
 
0 请求成功
 
1000 appid或appkey错误
 
2000 API次数调用超过上限
 
3000 API权限不足







	
		

			

				

					
					
					
				

				
CopyRight © 2015-2022 京推推 www.jingtuitui.com 浙ICP备17019584号