diff --git a/.github/ISSUE_TEMPLATE/1-update-request.yml b/.github/ISSUE_TEMPLATE/1-add-request.yml similarity index 62% rename from .github/ISSUE_TEMPLATE/1-update-request.yml rename to .github/ISSUE_TEMPLATE/1-add-request.yml index 385a587..5661753 100644 --- a/.github/ISSUE_TEMPLATE/1-update-request.yml +++ b/.github/ISSUE_TEMPLATE/1-add-request.yml @@ -1,13 +1,14 @@ -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 @@ -34,7 +35,7 @@ body: options: - "REST" - "gRPC" - - "长连接数据帧（含 WebSocket、TCP）" + - "长连接数据帧（含 ws、TCP）" - "其他类型（请在详情中备注）" validations: required: true @@ -42,14 +43,14 @@ body: id: address attributes: label: "API 地址" - description: "REST 的 url，或 gRPC 的包名+服务名，更新时可为原文档链接" - placeholder: "e.g.: https://api.bilibili.com/x/..." + 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..4b62189 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2-update-request.yml @@ -0,0 +1,29 @@ +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<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 + 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..dc119aa --- /dev/null +++ b/.github/ISSUE_TEMPLATE/3-mistake-report.yml @@ -0,0 +1,64 @@ +name: "错误修正" +description: "发现文档内容有误并提交修正请求" +title: "[错误修正] <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<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: 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 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`<br />若登录设备无`buvid`则留空 | **json回复：** @@ -21,7 +21,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 | +| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />-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 位以 `*` 打码<br />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,