XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

增加 获取合集中的视频 的api

fab50db
Sparkle <16502567+zanjie1999@users.noreply.github.com>
提交于

代码差异

1 个文件 +182 -0
Modified docs/creativecenter/season.md +182 -0
@@ -728,3 +728,185 @@ curl -X POST 'https://member.bilibili.com/x2/creative/web/season/del' \
728 728 ```
729 729
730 730 </details>
731
732 ## 获取合集中的视频
733
734 可以在给合集排序时使用
735
736 > https://member.bilibili.com/x2/creative/web/season/section?id=3898622
737
738 *请求方式: POST*
739
740 认证方式: Cookie (SESSDATA)
741
742 **正文参数 (application/x-www-form-urlencoded):**
743
744 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
745 | ----- | --- | ---- | ----- | --- |
746 | id | num | 合集 ID | 必要 | |
747
748 **JSON回复:**
749
750 | 字段 | 类型 | 内容 | 备注 |
751 | ------- | ---- | -------- | ---- |
752 | code | num | 返回值 | 0:成功 |
753 | message | str | 错误信息 | |
754 | ttl | num | 1 | |
755 | data | obj | 信息本体 | |
756
757 `data`对象:
758
759 | 字段 | 类型 | 内容 | 备注 |
760 | --------- | ---- | ------------ | ---- |
761 | seasons | obj | 合集信息 | |
762 | episodes | arr | 合集中的视频 | |
763
764 `seasons`对象:
765
766 | 字段 | 类型 | 内容 | 备注 |
767 | --------- | ---- | ------------ | ---- |
768 | id | num | 合集 ID | |
769 | type | num | 合集类型 | |
770 | cover | str | 合集封面 URL | |
771 | isEnd | num | 是否已完结? | 0: 未完结 |
772 | state | num | 合集状态? | 0: 正常显示<br />-6: 正在审核 |
773 | partState | num | 合集分段状态? | 0 |
774 | rejectReason | str | 合集拒绝原因? | |
775 | ctime | num | 创建时间 | |
776 | mtime | num | 修改时间 | |
777 | epCount | num | 视频总数 | |
778 | show | num | 是否公开? | 1: 公开 |
779 | has_charging_pay | num | 是否充电付费? | 0: 否 |
780
781 `episodes`数组中的对象:
782
783 | 字段 | 类型 | 内容 | 备注 |
784 | --------- | ---- | ------------ | ---- |
785 | id | num | 合集内视频 ID | |
786 | title | str | 视频标题 | |
787 | aid | num | 视频 aid | |
788 | bvid | str | 视频 bvid | |
789 | cid | num | 视频 cid | |
790 | seasonId | num | 合集 ID | |
791 | sectionId | num | 小节 ID | |
792 | order | num | 排序编号 | |
793 | videoTitle | str | 视频标题 | |
794 | archiveTitle | str | 看起来也是标题 | |
795 | archiveState | num | 0 | |
796 | rejectReason | str | 拒绝理由? | |
797 | state | num | 0 | |
798 | cover | str | 封面 URL | |
799 | is_free | num | 是否免费? | 0: 免费 |
800 | aid_owner | bool | 是否视频所有者 | true:是所有者 |
801 | charging_pay | num | 充电付费? | 0: 否 |
802
803
804 **示例:**
805
806 获取合集176088的视频列表 `id=3541327`
807
808 ```shell
809 curl -X GET 'https://member.bilibili.com/x2/creative/web/season/section?id=176088' \
810 -b 'SESSDATA=xxx; bili_jct=xxx'
811 ```
812
813 <details>
814 <summary>查看响应示例:</summary>
815
816 会返回全部的,由于很长,这里只保留三个作为例子
817
818 ```json
819 {
820 "code": 0,
821 "message": "0",
822 "ttl": 1,
823 "data": {
824 "section": {
825 "id": 176088,
826 "type": 1,
827 "seasonId": 152812,
828 "title": "正片",
829 "order": 1,
830 "state": 0,
831 "partState": 0,
832 "rejectReason": "",
833 "ctime": 1643250822,
834 "mtime": 1739466002,
835 "epCount": 112,
836 "cover": "http://i1.hdslb.com/bfs/archive/4439a182b142d92a169609e6e14e7217b3e14e0d.jpg",
837 "has_charging_pay": 0,
838 "Episodes": null,
839 "show": 1,
840 "has_pugv_pay": 0
841 },
842 "episodes": [
843 {
844 "id": 109100674,
845 "title": "「开箱评测」三星Note8 EMR2笔对比公版Wacom笔 套娃笔首选 10寸 RK PX30 Wacom 电子书 天喻墨学 M2 M3",
846 "aid": 113997323963614,
847 "bvid": "BV14BNfeSE5c",
848 "cid": 28376042631,
849 "seasonId": 152812,
850 "sectionId": 176088,
851 "order": 1,
852 "videoTitle": "「开箱评测」三星Note8 EMR2笔对比公版Wacom笔 套娃笔首选 10寸 RK PX30 Wacom 电子书 天喻墨学 M2 M3",
853 "archiveTitle": "「开箱评测」三星Note8 EMR2笔对比公版Wacom笔 套娃笔首选 10寸 RK PX30 Wacom 电子书 天喻墨学 M2 M3",
854 "archiveState": 0,
855 "rejectReason": "",
856 "state": 0,
857 "cover": "",
858 "is_free": 0,
859 "aid_owner": true,
860 "charging_pay": 0,
861 "member_first": 0,
862 "pugv_pay": 0
863 },
864 {
865 "id": 108733886,
866 "title": "「开箱评测」拆解 椭圆形的第三方AirTag GRTSZ S2 Tag",
867 "aid": 113982291576104,
868 "bvid": "BV1YyNvetEbX",
869 "cid": 28325121446,
870 "seasonId": 152812,
871 "sectionId": 176088,
872 "order": 2,
873 "videoTitle": "「开箱评测」拆解 椭圆形的第三方AirTag GRTSZ S2 Tag",
874 "archiveTitle": "「开箱评测」拆解 椭圆形的第三方AirTag GRTSZ S2 Tag",
875 "archiveState": 0,
876 "rejectReason": "",
877 "state": 0,
878 "cover": "",
879 "is_free": 0,
880 "aid_owner": true,
881 "charging_pay": 0,
882 "member_first": 0,
883 "pugv_pay": 0
884 },
885 {
886 "id": 106045797,
887 "title": "「开箱评测」这帕姆怎么射不出来呢! 星穹铁道 KFC联动 财神帕姆 太可爱了",
888 "aid": 113892936122993,
889 "bvid": "BV1ZFFKeTEkr",
890 "cid": 28087484764,
891 "seasonId": 152812,
892 "sectionId": 176088,
893 "order": 3,
894 "videoTitle": "「开箱评测」这帕姆怎么射不出来呢! 星穹铁道 KFC联动 财神帕姆 太可爱了",
895 "archiveTitle": "「开箱评测」这帕姆怎么射不出来呢! 星穹铁道 KFC联动 财神帕姆 太可爱了",
896 "archiveState": 0,
897 "rejectReason": "",
898 "state": 0,
899 "cover": "",
900 "is_free": 0,
901 "aid_owner": true,
902 "charging_pay": 0,
903 "member_first": 0,
904 "pugv_pay": 0
905 }
906 ]
907 }
908 }
909 ```
910
911 </details>
912