From a2161708ce5126ccece299ef88c02ef59ad371e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=99=A8=E5=8F=B6=E6=A2=A6=E6=98=A5?= <65224318+wuziqian211@users.noreply.github.com> Date: Fri, 2 May 2025 09:35:55 +0800 Subject: [PATCH 1/5] feat(login_notice.md): improve docs --- docs/login/login_notice.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/login/login_notice.md b/docs/login/login_notice.md index 73f6b5f..17a0761 100644 --- a/docs/login/login_notice.md +++ b/docs/login/login_notice.md @@ -12,7 +12,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ------ | ------------------------------------------------------------ | -| mid | num | 用户mid | 必要 | | +| mid | num | 用户mid | 必要 | 必须为自己的mid | | buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`
若登录设备无`buvid`则留空 | **json回复：** @@ -21,7 +21,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | +| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
-403：访问权限不足 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | | data | obj | 信息本体 | | @@ -114,7 +114,7 @@ curl -G 'https://api.bilibili.com/x/safecenter/login_notice' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------------- | ---- | -| ip | str | 登录 IP | 末两位以 `*` 打码 | +| ip | str | 登录 IP | IPv4：末 2 位以 `*` 打码
IPv6：末 5 位以 `*` 打码 | | time | num | 登录时间 | UNIX 秒级时间戳 | | time_at | str | 登录时间 | 格式为 `yyyy-MM-dd HH:mm:ss` | | status | bool | 是否登录成功? | | @@ -139,8 +139,16 @@ curl -G "https://api.bilibili.com/x/member/web/login/log" \ "message": "0", "ttl": 1, "data": { - "count": 14, + "count": 15, "list": [ + { + "ip": "240e:*:*:*:*:*:*:*", + "time": 1746038055, + "time_at": "2025-05-01 02:34:15", + "status": true, + "type": 0, + "geo": "中国广西梧州电信" + }, { "ip": "108.181.*.*", "time": 1722036741, From 8a355f4247a22586d2a6558f4b60b5f8201c97ed Mon Sep 17 00:00:00 2001 From: z0z0r4 Date: Fri, 2 May 2025 10:04:45 +0800 Subject: [PATCH 2/5] =?UTF-8?q?chore:=20=E6=8B=86=E5=88=86=20issue=20templ?= =?UTF-8?q?ate=20=E6=96=B9=E4=BE=BF=E8=87=AA=E5=8A=A8=E6=B7=BB=E5=8A=A0=20?= =?UTF-8?q?labels?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...1-update-request.yml => 1-add-request.yml} | 20 +++--- .github/ISSUE_TEMPLATE/2-update-request.yml | 27 ++++++++ .github/ISSUE_TEMPLATE/3-mistake-report.yml | 62 +++++++++++++++++++ 3 files changed, 100 insertions(+), 9 deletions(-) rename .github/ISSUE_TEMPLATE/{1-update-request.yml => 1-add-request.yml} (66%) create mode 100644 .github/ISSUE_TEMPLATE/2-update-request.yml create mode 100644 .github/ISSUE_TEMPLATE/3-mistake-report.yml diff --git a/.github/ISSUE_TEMPLATE/1-update-request.yml b/.github/ISSUE_TEMPLATE/1-add-request.yml similarity index 66% rename from .github/ISSUE_TEMPLATE/1-update-request.yml rename to .github/ISSUE_TEMPLATE/1-add-request.yml index 9693f2f..dbdb2f5 100644 --- a/.github/ISSUE_TEMPLATE/1-update-request.yml +++ b/.github/ISSUE_TEMPLATE/1-add-request.yml @@ -1,19 +1,21 @@ -name: "新增/更新请求" -description: "请求添加/补充/更新文档中的 API 定义" -title: "[新增/更新请求] " +name: "新增请求" +description: "请求添加文档中未收录的 API 定义" +title: "[新增请求] <title>" +labels: ["新增/Add"] body: - type: checkboxes id: reminders attributes: label: "提交前请确认" options: - - label: "我已检索仓库中文档，不包含所提及内容，或所提及内容在本仓库中存在错误，且 Issues、Pull Requests 中无相关提交" + - label: "我已检索仓库中文档，确认不包含所提及内容，且 Issues、Pull Requests 中无相关提交" required: true - type: dropdown id: source attributes: label: "API 来源" description: "该 API 在何平台中使用" + multiple: true options: - "Web 端（含 h5）" - "PC 客户端（Electron）" @@ -38,17 +40,17 @@ body: validations: required: true - type: input - id: adderss + id: address attributes: label: "API 地址" - description: "REST 的 url，或 gRPC 的包名+服务名，更新时可为原文档链接" + description: "REST 的 url，或 gRPC 的包名+服务名" placeholder: "eg: https://api.bilibili.com/2333333" validations: - required: false + required: true - type: textarea id: details attributes: label: "详情描述" - description: "新增时请描述该 API 的使用场景、请求及响应字段等，可附上原始抓包记录；更新时请指出原文档中与最新 API 行为不符之处，并附上已知的最新改动" + description: "请描述该 API 的使用场景、请求及响应字段等，可附上原始抓包记录" validations: - required: true + required: true \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/2-update-request.yml b/.github/ISSUE_TEMPLATE/2-update-request.yml new file mode 100644 index 0000000..a46bd2a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2-update-request.yml @@ -0,0 +1,27 @@ +name: "更新请求" +description: "请求补充或更新文档中已有的 API 定义" +title: "[更新请求] <title>" +labels: ["更新/Update"] +body: + - type: checkboxes + id: reminders + attributes: + label: "提交前请确认" + options: + - label: "我已确认文档中相关内容存在错误或不足，且 Issues、Pull Requests 中无相关提交" + required: true + - type: input + id: document_link + attributes: + label: "原文档链接" + description: "需要更新的文档链接，指定到具体 API" + placeholder: "eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式 or https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式" + validations: + required: true + - type: textarea + id: details + attributes: + label: "更新内容" + description: "请指出原文档中与最新 API 行为不符之处，并附上已知的最新改动和验证信息" + validations: + required: true \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/3-mistake-report.yml b/.github/ISSUE_TEMPLATE/3-mistake-report.yml new file mode 100644 index 0000000..5fdb58b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/3-mistake-report.yml @@ -0,0 +1,62 @@ +name: "错误修正" +description: "发现文档内容有误并提交修正请求" +title: "[错误修正] <标题>" +labels: ["错误/Mistakes"] +body: + - type: checkboxes + id: confirmations + attributes: + label: "提交前请确认" + options: + - label: "我已确认文档中的错误存在，且 Issues、Pull Requests 中无相同修正" + required: true + - label: "我已验证修正内容的正确性" + required: false + + - type: input + id: document_link + attributes: + label: "错误所在文档链接" + description: "需要修正的文档链接，指定到具体 API" + placeholder: "eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式 or https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式" + validations: + required: true + + - type: dropdown + id: error_type + attributes: + label: "错误类型" + multiple: true + options: + - "API 地址/鉴权方式错误" + - "参数错误" + - "响应数据结构或响应示例错误" + - "描述性内容错误（如拼写/流程说明）" + - "接口已弃用下线" + - "其他（请在下文说明）" + validations: + required: true + + - type: textarea + id: error_description + attributes: + label: "错误描述" + description: "请详细说明具体错误所在，如有多个错误请编号列出" + validations: + required: true + + - type: textarea + id: evidence + attributes: + label: "纠错依据" + description: "如果有，请提供抓包记录等佐证，方便确认。如果有多个错误，请将依据对应错误描述的编号列出" + validations: + required: false + + - type: textarea + id: correction + attributes: + label: "修正方案" + description: "如果可以，请提供修正后的内容，如有多个修正点请编号列出" + validations: + required: false \ No newline at end of file From 3f7aa4532a95fc418eea80cf679a6c1877c54791 Mon Sep 17 00:00:00 2001 From: z0z0r4 <z0z0r4@outlook.com> Date: Fri, 2 May 2025 10:51:12 +0800 Subject: [PATCH 3/5] =?UTF-8?q?fix:=20=E4=BF=AE=E6=AD=A3=20issue=20?= =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E4=B8=AD=20iOS=20=E5=92=8C=20TV=20=E5=AE=A2?= =?UTF-8?q?=E6=88=B7=E7=AB=AF=E7=9A=84=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/1-add-request.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/1-add-request.yml b/.github/ISSUE_TEMPLATE/1-add-request.yml index dbdb2f5..5661753 100644 --- a/.github/ISSUE_TEMPLATE/1-add-request.yml +++ b/.github/ISSUE_TEMPLATE/1-add-request.yml @@ -20,8 +20,8 @@ body: - "Web 端（含 h5）" - "PC 客户端（Electron）" - "Android 客户端（含粉版、平板版、蓝版、概念版、国际版等）" - - "TV 客户端（含云试听小电视、车机、物联网版等）" - - "IOS 客户端（含粉版、平板版、概念版等）" + - "TV 客户端（含云视听小电视、车机、物联网版等）" + - "iOS 客户端（含粉版、平板版、概念版等）" - "必剪客户端" - "漫画客户端" - "其他（请在详情中备注）" From f4aae291f182c0c51230e1bf2d437ca0c2f4bbc1 Mon Sep 17 00:00:00 2001 From: z0z0r4 <z0z0r4@outlook.com> Date: Fri, 2 May 2025 10:53:15 +0800 Subject: [PATCH 4/5] =?UTF-8?q?fix:=20=E4=BF=AE=E6=AD=A3=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E6=A8=A1=E6=9D=BF=E4=B8=AD=E7=9A=84=20<title?= =?UTF-8?q?>?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/3-mistake-report.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/3-mistake-report.yml b/.github/ISSUE_TEMPLATE/3-mistake-report.yml index 5fdb58b..f9f5ef7 100644 --- a/.github/ISSUE_TEMPLATE/3-mistake-report.yml +++ b/.github/ISSUE_TEMPLATE/3-mistake-report.yml @@ -1,6 +1,6 @@ name: "错误修正" description: "发现文档内容有误并提交修正请求" -title: "[错误修正] <标题>" +title: "[错误修正] <title>" labels: ["错误/Mistakes"] body: - type: checkboxes From f91f636fd585f2c7958ce780086503932b3382a0 Mon Sep 17 00:00:00 2001 From: z0z0r4 <z0z0r4@outlook.com> Date: Fri, 2 May 2025 11:04:10 +0800 Subject: [PATCH 5/5] =?UTF-8?q?fix:=20=E6=96=87=E6=A1=A3=E9=93=BE=E6=8E=A5?= =?UTF-8?q?=20eg=20=E6=8D=A2=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/2-update-request.yml | 6 ++++-- .github/ISSUE_TEMPLATE/3-mistake-report.yml | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/2-update-request.yml b/.github/ISSUE_TEMPLATE/2-update-request.yml index a46bd2a..4b62189 100644 --- a/.github/ISSUE_TEMPLATE/2-update-request.yml +++ b/.github/ISSUE_TEMPLATE/2-update-request.yml @@ -14,8 +14,10 @@ body: id: document_link attributes: label: "原文档链接" - description: "需要更新的文档链接，指定到具体 API" - placeholder: "eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式 or https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式" + description: | + 需要更新的文档链接，指定到具体 API<br> + eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式<br> + https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式 validations: required: true - type: textarea diff --git a/.github/ISSUE_TEMPLATE/3-mistake-report.yml b/.github/ISSUE_TEMPLATE/3-mistake-report.yml index f9f5ef7..dc119aa 100644 --- a/.github/ISSUE_TEMPLATE/3-mistake-report.yml +++ b/.github/ISSUE_TEMPLATE/3-mistake-report.yml @@ -17,8 +17,10 @@ body: id: document_link attributes: label: "错误所在文档链接" - description: "需要修正的文档链接，指定到具体 API" - placeholder: "eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式 or https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式" + description: | + 需要修正的文档链接，指定到具体 API<br> + eg: https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/bangumi/info.md#获取剧集明细web端ssidepid方式<br> + https://socialsisteryi.github.io/bilibili-API-collect/docs/bangumi/info.html#获取剧集明细-web端-ssid-epid方式 validations: required: true