多多进宝：多多礼金生链API

摘要

本接口用于生成商品推广，即带优惠券、cps结算能力的链接，用户通过您的链接下单且无售后情况，订单佣金将会返回给您。单品生链最基础的用法就是 输入client_id, goodsId (优先使用goodsSign代替), 以及推广位pid（以及相应授权备案信息custom_parameters） 来生成相应的推广链接

多多客生链接口: pdd.ddk.goods.promotion.url.generate

开平地址：https://open.pinduoduo.com/application/document/api?id=pdd.ddk.goods.promotion.url.generate

进宝文档地址：https://jinbao.pinduoduo.com/third-party/api-detail?apiName=pdd.ddk.goods.promotion.url.generate

接口介绍：

本接口用于生成商品推广，即带优惠券、cps结算能力的链接，用户通过您的链接下单且无售后情况，订单佣金将会返回给您。

使用方法：

• 单品生链最基础的用法就是 输入client_id, goodsId (优先使用goodsSign代替), 以及推广位pid（以及相应授权备案信息custom_parameters） 来生成相应的推广链接

• 生成多多礼金链接，需要带上crash_gift_id

• 生成多多礼金链接时，针对crash_gift_id会进行以下校验：

  • crash_gift_id对应的礼金包是否存在，且有效。（状态为未生效和生效中）

  • 礼金是否属于当前duoid创建（clientid）

  • 入参pid是否有权限生成该礼金链接

  • 入参goodsId是否与礼金对应

注意点：

使用生链接口需要授权备案，这里授权备案有两种方式：

• 业务平台在使用生链接口前，先引导用户进行授权备案（https://jinbao.pinduoduo.com/qa-system?questionId=218），授权备案成功后，需要在调用生链接口时，正确填写授权信息(pid 以及 对应的custom_parameters)。

• 在生链接口中，有generate_authority_url入参，该参数表示是否生成带授权的单品链接。针对未授权的用户，可以将该字段置为true，生成待授权的链接，如果未授权，则会走授权流程。

返回的参数中，主要有以下几种url:

• mobile_url: 推广移动链接，用户安装拼多多APP的情况下会唤起APP，否则唤起H5页面

• mobile_short_url： 推广移动短链接, 对应mobile_url，功能一致

• schema_url： schema链接，用户安装拼多多APP的情况下会唤起APP（需客户端支持schema跳转协议）

• url：普通推广长链接，唤起H5页面

• short_url：普通推广短链接，唤起H5页面