商家将商品库存信息同步至平台,可以精准展示店铺在售商品的库存量,能规避缺货情况的发生、提升订单处理效率。利用电商管理系统同步库存信息是电商商家和企业目前普遍采用的、用以提升业务管理效率的方式,库存更新同步接口是电商管理系统开发者必须对接的API接口之一。
如何通过B站API实现库存更新同步呢?B站开放平台提供了库存同步接口,商家自研系统或开发者开发电商功能时对接了B站API的库存更新接口,就能将系统中的库存信息同步至B站的电商平台,我们一起来了解一下B站API中的库存更新接口吧。
B站库存更新接口
Scope: SHOP_STOCK_INFO 需要申请权限 需要用户授权
接口说明
· 调用该接口可更新库存
请求URL
https://member.bilibili.com/arcopen/fn/v2/market/stock/update
请求方式
POST
请求头
请求增加公共请求头(Request Header),详情咨询客服
请求参数
· url参数
无
· body参数
参数名 | 必传 | 类型 | 备注 |
modify_stock_list | true | list | 库存更新列表 |
sku_id | true | int | bilibili商品ID(SKU) |
zp_entity_stock_offset | true | int | model=1时增量更新当前可售库存值;model=2时全量更新当前可售库存值; |
mode | false | int | 库存更新模式:1.增量更新 2.全量更新 默认为1 |
· 请求样例
1. curl--location--request POST'https://member.bilibili.com/arcopen/fn/v2/market/stock/update?client_id=8ca079bc20ce433d&access_token=627e014557e53ecd13e43db39f159b11' \
2. --header'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
3. --header'Content-Type: application/json' \
4. --header'x-bili-timestamp: 1712473117' \
5. --header'x-bili-signature-method: HMAC-SHA256' \
6. --header'x-bili-signature-version: 1.0' \
7. --header'Authorization: afdf0ddc6dd8f5af9c7f25cf3115a03142e67df99e15f909a17c11e4c82ad4f9' \
8. --header'x-bili-signature-nonce: 1712473117993237000' \
9. --header'x-bili-accesskeyid: 8ca079bc20ce433d' \
10. --header'x-bili-content-md5: 795a2d7e13f989cee460801379fe543c' \
11. --header'Accept: */*' \
12. --header'Host: member.bilibili.com' \
13. --header'Connection: keep-alive' \
14. --data-raw'{
15. "mode": 1,
16. "modify_stock_list": [
17. {
18. "sku_id": 1002884494,
19. "zp_entity_stock_offset": 10
20. }
21. ]
22. }'
响应参数
· body参数
参数名 | 必传 | 类型 | 备注 |
failed_skus | true | list | 失败列表 |
message | true | string | 失败信息 |
stock_id | true | int | - |
· 响应样例
1. {
2. "code": 0,
3. "message": "0",
4. "ttl": 1,
5. "data": {
6. "failed_skus": [
7. {
8. "stock_id": 4026256766985461,
9. "message": "失败信息"
10. }
11. ]
12. }
13. }