pokeface/jingdong-league

There is no license information available for the latest version (1.2) of this package.

1.2 2019-08-06 05:36 UTC

This package is auto-updated.

Last update: 2020-07-30 10:14:40 UTC


README

##授权 #####实例化

        $open = Factory::openAuthPlatForm();


####详参

获取分类

方法名 方法示例 参数
获取授权code链接 $open->generateCode->url($data) 详细参数
获取授权AccessToken $app->accessToken->request($data) 详细参数
用refresh换取token $app->refreshAccessToken->request($data) 详细参数
获取推广位 $a->promotionSiteQuery->request($data) 详细参数
创建推广位 $a->promotionSiteCreate->request($data) 详细参数
工具商同步订单 $open->syncOrderWithKey->request($data) 详细参数
优惠券,商品二合一转接API-通过unionId获取推广链接 $open->couponCodeByUnionId->request($data) 详细参数

获取授权Code链接

参数名 参数类型 是否必填 参数样例 参数简介
app_key string AB297235xxxxxFE65FB2A0BFB14A Appkey
redirect_uri string www.xxxx.com 回调地址

获取授权AccessToken

参数名 参数类型 是否必填 参数样例 参数简介
app_key string AB297235xxxxxFE65FB2A0BFB14A Appkey
app_secret string 5ed41bwfewafwe5a4c46b1cdcbd79481cc0e secret
grant_type string authorization_code 固定
code string xxxxxx 获取授权code链接的code

用refresh换取token

参数名 参数类型 是否必填 参数样例 参数简介
app_key string AB297235xxxxxFE65FB2A0BFB14A Appkey
app_secret string 5ed41bwfewafwe5a4c46b1cdcbd79481cc0e secret
grant_type string refresh_token 固定
refresh_token string xxxxxx 刷新token

获取推广位

参数名 参数类型 是否必填 参数样例 参数简介
unionId string 10111113967 站点ID
key string ece3b6ab1czzzzzzdb4ccf976c3d65745aa8e1481d1e0a50ec 授权Key
pageNo int 1 页码
pageSize int 12 显示个数

获取推广位

参数名 参数类型 是否必填 参数样例 参数简介
unionId string 10111113967 站点ID
key string ece3b6ab1czzzzzzdb4ccf976c3d65745aa8e1481d1e0a50ec 授权Key
unionType int 1 常数1
siteId int 12 对应type的ID
type int 12 1网站推广位2.APP推广位3.社交媒体推广位4.聊天工具推广位5.二维码推广
spaceName int 12 推广位名

工具商同步订单

参数名 参数类型 是否必填 参数样例 参数简介
key string ece3b6ab1czzzzzzdb4ccf976c3d65745aa8e1481d1e0a50ec 授权Key
time int 1 页码
pageSize int 12 显示个数

优惠券,商品二合一转接API-通过unionId获取推广链接

参数名 参数类型 是否必填 参数样例 参数简介
couponUrl string http://coupon.m.jd.com/coupons/show.action?key=42b0e3cb1d50489caa3fa2ba5ef1d077&roleId=20354624&to=ytfzyybj.jd.com 优惠券链接
materialIds int 1232131321 商品skuID
unionId int 12111111 联盟ID
positionId int 12 推广位id
pid string 12fea_2312321_fefef 子帐号身份标识
京东官方订单接口返回值
以JSONArray的字符串格式返回查询结果——success:接口调用是否成功(1:成功,0:失败)
 hasMore:(true:还有数据 false:已查询完毕,没有数据)
 data:返回数据
finishTime:订单完成时间
orderEmt:下单设备(1:PC,2:无线);
orderId:订单ID;
orderTime:下单时间;
parentId:父单ID(订单拆分后,父单的订单号);
payMonth:结算日期(yyyyMMdd)
plus:plus会员(0:不是,1:是);
popId:商家ID;
unionId:站长ID;
validCode:有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,10.无效-开增值税专用发票订单,11.无效-乡村推广员下单,12.无效-自己推广自己下单,13.无效-违规订单,14.无效-来源与备案网址不符,15.待付款,16.已付款,17.已完成,18.已结算)
unionUserName:扩展信息(euId,需要联系运营开放白名单才能拿到数据)
 skuList:商品结果集;
	skuId:商品ID;
	skuName:商品名称;
	skuNum:商品数量;
	skuReturnNum:商品已退货数量;
	frozenSkuNum:商品售后中数量;
	price:商品单价;
	payPrice:实际支付金额;
	commissionRate:佣金比例;
	subSideRate:分成比例;
	subsidyRate:补贴比例;
	finalRate:最终比例 (一级分佣比例*二级分佣比例);
	estimateCosPrice:预估计佣金额;
	estimateCommission:预估佣金;
	estimateFee:站长的预估佣金;
	actualCosPrice:实际计佣金额;
	actualCommission:实际佣金;
	actualFee:站长的实际佣金;
	validCode:有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,10.无效-开增值税专用发票订单,11.无效-乡村推广员下单,12.无效-自己推广自己下单,13.无效-违规订单,14.无效-来源与备案网址不符,15.待付款,16.已付款,17.已完成,18.已结算)
	traceType:2同店 3跨店
	spId:推广位ID
	siteId:网站ID
	unionAlias:第三方服务来源
	pid:格式:子站长ID_子站长网站ID_子站长推广位ID
	unionTrafficGroup:渠道组(1:1号店,其他:京东)
	firstLevel:一级类目
	secondLevel:二级类目
	thirdLevel:三级类目
	subUnionId:子联盟ID(需要联系运营开放白名单才能拿到数据)
unionTag:联盟标签数据(整型的二进制字符串(32位),目前只返回8位:00000001。数据从右向左进行,每一位为1表示符合联盟的标签特征,第1位:优惠券,第2位:组合推广订单,第3位:拼购订单,第4位:首次购订单。例如:00000001:优惠券,00000010:组合推广订单,00000100:拼购订单,00001000:首次购,00000111:优惠券+组合推广+拼购等)

##京东联盟 #####实例化

$app= Factory::union([
      'app_key' => '111',
      'app_secret'=>'222',
      'format' => 'json',
      'v' => '1.0',
      'sign_method' => 'md5'
]);


####详参

获取分类

方法名 方法示例 参数
获取分类 $app->categoryGoods->request($data) 详细参数
京粉精选商品 $app->jingfenGoods->request($data) 详细参数
关键词商品查询接口(需申请) $app->goods->request($data) 详细参数
获取通用推广链接 $app->common->request($data) 详细参数
获取订单信息 $app->order->request($data); 详细参数
获取推广商品详情 $app->promotionGoods->request($data); 详细参数
创建推广位 $app->positionCreate->request($data) 详细参数

创建推广位

参数名 参数类型 是否必填 参数样例 参数简介
unionId string 10111113967 站点ID
key string ece3b6ab1czzzzzzdb4ccf976c3d65745aa8e1481d1e0a50ec 授权Key
unionType int 1 常数1
siteId int 12 对应type的ID
type int 12 1网站推广位2.APP推广位3.社交媒体推广位4.聊天工具推广位5.二维码推广
spaceName array ['abc','def'] 推广位名

获取分类

参数名 参数类型 是否必填 参数样例 参数简介
parentId int 1342 父类目id(一级父类目为0)
grade int 2 类目级别(类目级别 0,1,2 代表一、二、三级类目)

京粉精选商品

参数名 参数类型 是否必填 参数样例 参数简介
eliteId int 11 频道id:1-好券商品,2-京粉APP-jingdong.大咖推荐,3-小程序-jingdong.好券商品,4-京粉APP-jingdong.主题街1-jingdong.服装运动,5-京粉APP-jingdong.主题街2-jingdong.精选家电,6-京粉APP-jingdong.主题街3-jingdong.超市,7-京粉APP-jingdong.主题街4-jingdong.居家生活,10-9.9专区,11-品牌好货-jingdong.潮流范儿,12-品牌好货-jingdong.精致生活,13-品牌好货-jingdong.数码先锋,14-品牌好货-jingdong.品质家电,15-京仓配送,16-公众号-jingdong.好券商品,17-公众号-jingdong.9.9,18-公众号-jingdong.京仓京配
pageIndex int 1 页码
pageSize int 20 每页数量,默认20,上限50
sortName String price 排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30DaysSku:sku维度30天引单量,comments:评论数,goodComments:好评数)
sort String desc asc,desc升降序,默认降序

关键词商品查询接口

参数名 参数类型 是否必填 参数样例 参数简介
cid1 long 737 一级类目id
cid2 long 738 二级类目id
cid3 long 739 三级类目id
pageIndex int 1 页码
pageSize int 20 每页数量,单页数最大30,默认20
skuIds long[] 5225346,7275691 skuid集合(一次最多支持查询100个sku),数组类型开发时记得加[]
keyword String 手机 关键词,字数同京东商品名称一致,目前未限制
pricefrom double 16.88 商品价格下限
priceto double 19.95 商品价格上限
commissionShareStart int 10 佣金比例区间开始
commissionShareEnd int 50 佣金比例区间结束
owner String g 商品类型:自营[g],POP[p]
sortName String price 排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30Days:30天引单量, inOrderComm30Days:30天支出佣金)
sort String desc asc,desc升降序,默认降序
isCoupon int 1 是否是优惠券商品,1:有优惠券,0:无优惠券
isPG int 1 是否是拼购商品,1:拼购商品,0:非拼购商品
pingouPriceStart double 16.88 拼购价格区间开始
pingouPriceEnd double 19.95 拼购价格区间结束
isHot int 1 是否是爆款,1:爆款商品,0:非爆款商品
brandCode String 7998 品牌code
shopId int 45619 店铺Id

获取通用推广链接

参数名 参数类型 是否必填 参数样例 参数简介
materialId String https://item.jd.com/23484023378.html 推广物料
siteId String 435676 站点id
positionId long 6 推广位id
subUnionId String 618_18_c35***e6a 子联盟ID(需要联系运营开通权限才能拿到数据)
ext1 String 100_618_618 推客生成推广链接时传入的扩展字段(查看订单对应字段信息,需要联系运营开放白名单才能看到)
pid String 618_618_6018 联盟子站长身份标识,格式:子站长ID_子站长网站ID_子站长推广位ID
shopId int 45619 店铺Id

获取订单信息

参数名 参数类型 是否必填 参数样例 参数简介
pageNo String 1 页码
pageSize int 500 最大显示500
type int 1 订单时间查询类型(1:下单时间,2:完成时间,3:更新时间)
time String 2019052111 查询时间,建议使用分钟级查询,格式:yyyyMMddHH、yyyyMMddHHmm或yyyyMMddHHmmss,如201811031212 的查询范围从12:12:00--12:12:59

获取推广商品详情

参数名 参数类型 是否必填 参数样例 参数简介
skuIds String 3907427,12321321 商品ID