当前位置:淘客联盟接口开发文档(旧版) > member组创建
接口文档

淘宝联盟member组创建和查询,商品id转新字符ID接口

迁移提示这是 旧版 文档, 最新文档请点击这里查看

本文档包含三个淘宝联盟新接口:

1.member组创建接口

2.数字ID转字符型ID的B段接口(9.15下线)

3.新字符ID一期商品,可用于测试和下单


三个接口用于在2022年9月16号前帮助您测试和准备对接新字符型ID。

请多关注网站和会员群公告,会有新的商品ID升级通知。


一、接口1:member组创建接口

接口用途和含义:

由于升级后的新字符型ID是动态的AAA-BBBB结构,前半段A是动态变化的,后半段B则是“同一商品+同一联盟帐号”固定的模式。

如果同一家公司,如有多个淘宝客账号,在这种结构下查询订单,会出现相同商品,但因为用了不同的联盟号,所以导致订单接口返回的商品ID不同。如果您有统计需求,就无法判断member a和member b取出的商品X是不是同一个。因此就有了member组的需求。


您名下多个淘宝客账号,需要聚合统计多member订单数据,可以通过虚拟member组API”,该接口支持创建虚拟member组,创建成功后拉取组内所有member订单数据(仅有效授权账号可拉取,需要入参member组ID)同商品的新商品ID在特定范围内不变(范围可能有周期等因素);


【接口权限】核心接口会员卡

【接口地址】

http://api.veapi.cn/tbk/membergroup?vekey=xxx&member_group_id=&tb_num_ids=11111,222222

【参数说明】

member_group_id : member组ID,仅当您调用本接口创建一个组后才有这个组ID,当提供本参数时,接口仅用于查询该组id下的成员列表。此时参数tb_num_ids无效。

tb_num_ids:当你要创建组时,请使用本参数传入会员淘宝主站id列表,就是授权时取得的user id字段值

【返回值】

查询member组330,

http://api.veapi.cn/tbk/membergroup?vekey=xxx&&member_group_id=330


返回如下:

{

    "error": "0",

    "msg": "member组成员查询成功!",

    "act_type": 1,

    "data": {

        "create_time": "2022-09-04 13:43:05",

        "member_group_id": "330",

        "tb_num_ids": "61781225,2151695",   //表示该组有两个成员 61781225,2151695

        "update_time": "2022-09-04 13:43:05"

    },

    "request_id": "cR8pjVa"

}



二、接口2:旧数字商品ID转新字符ID——刷库接口

接口用途:

如果您原来有自建商品库,保存的是旧的数字ID,在9月16号可能就不能正常使用了,因此尽快需要使用本接口刷库,把数字ID转为新的字符型ID,返回的是新ID的B段。后续有专用转链方式。

目前您需要做的是尽快在9.15前使用本接口,把商品库中的数字ID转成新字符型ID 的B段(建议暂时保留原数字ID字段)


问:B段如何转链?当您通过本接口获取商品新ID的B段后,要如何转链?

答:您可以使用本站万能转链接口hcapi,传入biz_scene_id=3的参数。注意场景3参数仅限用于刷库商品ID的B段,其它场景得到的B段不适合。请使用全段新商品ID传参转链。


【特别提示】如果有自建商品库的用户,并且有多个联盟号,请务必使用固定一个联盟号,做管理member,以后统一新ID的B段。

【接口权限】核心接口会员卡

【接口地址】刷库接口:

http://api.veapi.cn/tbk/itemidtransform?vekey=xxx&item_ids=11111,222222

【参数说明】

item_ids:原淘宝数字商品ID,目前测试ID可同时传参达100个以上,但会影响稳定性,会得到“远程服务调用超时”的错误。当频繁出现此错误时,请减少ID数。推荐20个

【返回值】

{

    "error": "0",

    "msg": "操作成功!数字ID转成新字符型ID!",

    "data": [

        {

            "item_id": "x27WbwCOO78jJQpsA",  //新字符型ID的B段

            "original_item_id": "659531747087"  //原数字ID

        },

        {

            "item_id": "38vQres06NjbjoKHO",  //注意如果没有这个字段,有可能不是淘客商品

            "original_item_id": "676449278182"

        }

    ],

    "request_id": "hFD3Uch"

}


三、新商品ID的货盘接口

9.1-9.15过程中如您修改完成后需要进行新商品ID调取,联盟侧提供了1个针对「淘工厂」商品的物料ID,可支持开发者在物料精选接口拉取新商品ID,用于链路闭环测试;

【接口权限】核心接口会员卡

【接口地址】

http://api.veapi.cn/tbk/newitems?vekey=xxx&page_no=1

【参数说明】

page_no:分页码,默认1

page_size:分页数,默认10

【返回值】

从返回值中取到的商品,可以用于下单。

{

    "category_id": 50014808,

    "click_url": "//s.click.taobao.com/t?e=m%3D2%...",

    "coupon_amount": 0,

    "coupon_start_fee": "0.0",

    "coupon_total_count": 0,

    "item_description": "纳米加厚,防水防晒",

    "item_id": "NOYy90qT5t2jBaGFZGDTRtB-g8Da92spoGV2J3aFGp",

    "pict_url": "//img.alicdn.co....3-0-C2M.jpg",

    "reserve_price": "3.9",

    "seller_id": 4793097890753034937,

    "sub_title": "纳米加厚,防水防晒",

    "title": "小红旗手摇旗小国旗小党旗8号7号中国国旗党旗红旗带杆手持手拿旗五星红旗迷你小旗帜装饰串旗纳米防水彩旗",

    "user_type": 1,

    "volume": 100,

    "zk_final_price": "2.46",

    "small_images": []

}


请尽快熟悉上述三个接口,用于测试和刷新商品库。请多关注网站和会员群公告,会有新的商品ID升级通知。

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部