B站直播礼物接口详解：哔哩哔哩-API收集整理中的打赏功能开发

B站直播礼物接口详解：哔哩哔哩-API收集整理中的打赏功能开发

在B站直播平台中，打赏功能是主播与观众互动的重要方式，而礼物接口则是实现这一功能的核心技术支撑。本文将详细介绍哔哩哔哩-API收集整理项目中关于直播礼物接口的相关内容，帮助开发者更好地理解和应用这些接口进行打赏功能的开发。

直播间礼物获取接口

要实现打赏功能，首先需要能够获取直播间内的礼物信息。在项目的docs/live/gift.md文件中，详细记录了获取直播间内礼物的接口。

该接口的请求地址为：https://api.live.bilibili.com/xlive/web-room/v1/giftPanel/roomGiftList，请求方式为GET，认证方式为无，无需添加Cookie。

接口的url参数如下表所示：

参数名	类型	内容	必要性	备注
platform	str	web	必要
room_id	num	主播房间号	必要
area_parent_id	num	直播分区	非必要	不填写可能会获取不到部分活动礼物
area_id	num	直播子分区	非必要	不填写可能会获取不到部分活动礼物

接口返回的json数据中，根对象包含code、message和data字段。其中，code为返回值，0表示成功；message为错误信息；data为信息本体。在data.gift_config.base_config.list数组中，包含了礼物的详细信息，如礼物id、名字、价格、类型等。

以下是一个查询room_id=23375552的直播间礼物信息的示例：

curl  'https://api.live.bilibili.com/xlive/web-room/v1/giftPanel/roomGiftList?platform=pc&room_id=23174842'

盲盒概率获取接口

除了普通礼物，B站直播中还有盲盒礼物。获取盲盒概率的接口同样在docs/live/gift.md中有详细说明。

该接口的请求地址为：https://api.live.bilibili.com/xlive/general-interface/v1/blindFirstWin/getInfo，请求方式为GET，认证方式为无。

接口的url参数只有gift_id，类型为num，是盲盒对应的礼物id，为必要参数。

接口返回的json数据根对象同样包含code、message和data字段。data对象中包含了盲盒的相关信息，如描述、价格、名字以及开出各种礼物的概率等。gifts数组中的每个对象则对应一种可能开出的礼物，包含礼物id、价格、名字、图片和概率等信息。

例如，查询“心动盲盒”概率的示例如下：

curl  'https://api.live.bilibili.com/xlive/general-interface/v1/blindFirstWin/getInfo?gift_id=32251'

礼物图标

通过对这些接口的了解和应用，开发者可以更好地实现B站直播的打赏功能，为用户提供更丰富的互动体验。在实际开发过程中，还需要根据具体需求进行接口的调用和数据的处理，同时要注意遵守B站的相关规定和接口使用限制。