商品推广链接生成
https://member.bilibili.com/arcopen/fn/market/live/commerce/generate/promotion/url
开放能力 / 交易电商 / 带货 / 接口
根据商品链接生成对应联盟的带货推广链接
body 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items_url | string | 是 | 原始链接 |
| url_list | List | 否 | 链接列表 |
| channel_code | string | 是 | 叶接入渠道Code |
| place_type | int | 是 | 资源位类型 |
| type | int | 是 | 类型,1-商品 2-淘礼金 |
| url | string | 是 | 链接 |
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items_name | string | 否 | 商品名 |
| items_url | string | 否 | 原始连接 |
| url_list | List | 否 | 转链结果 |
| type | int | 否 | 链接类型,1-商品 2-淘礼金 |
| jump_url | string | 否 | 转链链接 |
| promotion_error_message | string | 否 | 转链失败原因 |
调用方式
javascript
// 让 AI 直接调(需要开放平台凭据)
bili_api_call { "ref": "105", "query": {…}, "body": {…} }
// 只看将要发出的请求(不需要凭据)
bili_api_call { "ref": "105", "dryRun": true }
// 生成完整调用代码
bili_codegen { "ref": "105", "lang": "python" }官方请求示例
bash
curl --location --request POST 'https://member.bilibili.com/arcopen/fn/market/live/commerce/generate/promotion/url' \
--header 'Accept: application/json' \
--header 'Access-Token: a24e56a0fc0093668bca0f3a15410ea2' \
--header 'x-bili-timestamp: 1712473117' \
--header 'x-bili-signature-method: HMAC-SHA256' \
--header 'x-bili-signature-version: 2.0' \
--header 'Authorization: afdf0ddc6dd8f5af9c7f25cf3115a03142e67df99e15f909a17c11e4c82ad4f9' \
--header 'x-bili-signature-nonce: 1712473117993237000' \
--header 'x-bili-accesskeyid: 8ca079bc20ce433d' \
--header 'x-bili-content-md5: 795a2d7e13f989cee460801379fe543c' \
--header 'Content-Type: application/json' \
--header 'Host: member.bilibili.com' \
--header 'Connection: keep-alive' \
--data-raw '{
"items_url": "https://detail.tmall.com/item.htm?id=871808936421&ali_trackid=2:mm_3546734339_2765250049_114653600169:1737019883553_560407525_1&fromUld=1&spm=a2e0b.27956566.d1673245246709.1&union_lens=lensId:OPT@1736577453@21672f67_13d9_19454150c9f_2fea@024fj5ijALTWONY8Nfgo4H0R@eyJmbG9vcklkIjo2OTg4N30ie;recoveryid:201_33.6.247.53_20672946_1737019879683;prepvid:201_33.6.247.53_20672946_1737019879683&scm=20140767.59990_33_53_251_230_460_1737019880214.1%7Citem%7C871808936421.0&bxsign=tbknSFpYyk1Yn3DWHxAT1v2_NXGCLVKuuNgMj_xiEppxwS2l0GS508JgdcOeVb_PePByPGEORV321uPEzxw50igu6vobFfsEkVd7L_vYt96dW_gkFqNSbZ-1o5mH-kQP0KK2_mChWSSwlcL2SKzvIVuD8vwY6o5ubARakb3gzhIQAI",
"url_list": [
{
"type": 1,
"url": "https://s.click.taobao.com/9YfF90t"
}
],
"channel_code": "10001",
"place_type": 2
}'原始文档:105_商品推广链接生成.md(5830 字节)。用 bili_docs_get { "ref": "105" } 读全文,或用 bili_api_spec { "ref": "105" } 取结构化规格。