From 59515852cf2bdf54cae2af0a61539f6efd79476c Mon Sep 17 00:00:00 2001 From: Kamisato-Ayaka-233 <2627706725@qq.com> Date: Fri, 26 May 2023 20:28:57 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A02=E4=B8=AA=E7=AC=AC=E4=B8=89?= =?UTF-8?q?=E6=96=B9API?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 2 +- README.md | 7 ++- .../thirdparty/dictionary_of_item.md | 46 ++++++++++++++++ .../thirdparty/historical_up_items.md | 54 +++++++++++++++++++ 4 files changed, 106 insertions(+), 3 deletions(-) create mode 100644 genshin_impact/thirdparty/dictionary_of_item.md create mode 100644 genshin_impact/thirdparty/historical_up_items.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6f8e3f6..24680f7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -182,7 +182,7 @@ _请求方式：GET_ 每个字段应有： -- 字段（只有对象有，如果为数组则不需要该项。若数组按一定顺序放置数据，则替换该表头为“索引”） +- 字段（只有对象有，如果为数组则不需要该项。若数组按一定顺序放置数据，则替换该表头为“索引”。） - 类型（如果该数据在数组中，且该数组中的数据类型只有1种，则不需要该项） - 内容描述 - 备注 diff --git a/README.md b/README.md index 911afa4..46f6da3 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ ### 《原神（Genshin Impact，Genshin，hk4e）》 -《原神》游戏内的API。 +关于《原神》的API。 @@ -90,10 +90,13 @@ - [ ] [基本信息](genshin_impact/user/info.md) --> - [ ] [其它](genshin_impact/other/) - [ ] [公告](genshin_impact/other/announcement.md) + - [ ] [第三方API](genshin_impact/thirdparty/) + - [ ] [历史祈愿UP池](genshin_impact/thirdparty/historical_up_items) + - [ ] [项目ID与名称的字典](genshin_impact/thirdparty/dictionary_of_item) ### 《崩坏：星穹铁道（Honkai: Star Rail，Star Rail，hkrpg）》 -《崩坏：星穹铁道》游戏内的API。 +关于《崩坏：星穹铁道》的API。 查询玩家信息请查看[米游社](#米游社hoyolabmiyoushe)。 diff --git a/genshin_impact/thirdparty/dictionary_of_item.md b/genshin_impact/thirdparty/dictionary_of_item.md new file mode 100644 index 0000000..6402e50 --- /dev/null +++ b/genshin_impact/thirdparty/dictionary_of_item.md @@ -0,0 +1,46 @@ +# 项目ID与名称的字典 + +- [UIGF API](#uigf-api) +- [Caughtwind API](#caughtwind-api) + +--- + +## UIGF API + +_请求方式：GET_ + +`https://api.uigf.org/dict/genshin/{lang}.json` + +**导航参数：** + +| 字段 | 内容 | 备注 | +| ---- | ---- | --- | +| lang | 返回数据中文本的语言，支持如下语言：
chs
cht
de
en
es
fr
id
jp
kr
pt
ru
th
vi | | + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| “项目名称” | str | 项目ID | | + +## Caughtwind API + +_请求方式：GET_ + +`https://api.21cnt.cn/genshin/itemId` + +**参数：** + +| 字段 | 内容 | 备注 | +| ---- | ---- | --- | +| lang | 返回数据中文本的语言，支持如下语言：
chs | | + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| “项目名称” | str | 项目ID | | \ No newline at end of file diff --git a/genshin_impact/thirdparty/historical_up_items.md b/genshin_impact/thirdparty/historical_up_items.md new file mode 100644 index 0000000..636b0c5 --- /dev/null +++ b/genshin_impact/thirdparty/historical_up_items.md @@ -0,0 +1,54 @@ +# 历史祈愿UP池 + +- [Caughtwind API](#caughtwind-api) + +--- + +## Caughtwind API + +_请求方式：GET_ + +`https://api.21cnt.cn/genshin/banner` + + + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| “版本” | arr | 该版本祈愿UP池信息 | 第1个元素为上半卡池，第2个元素为下半卡池 | + +“版本”数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| time | arr | 卡池的开始与结束时间的Unix时间戳 | 时间以官方发布为准，若官方未发布时间，则为空 | +| character | obj | 该卡池UP的角色的ID | 若角色ID未知，则为角色名称 | +| weapon | obj | 该卡池UP的武器的ID | 若角色ID未知，则为角色名称 | + +“版本”数组→对象→`time`数组： + +| 索引 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| 0 | num | 开始时间的Unix时间戳 | | +| 1 | num | 结束时间的Unix时间戳 | | + +“版本”数组→对象→`character`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| 5r | arr | 五星角色的ID | | +| 4r | arr | 四星角色的ID | | + +“版本”数组→对象→`weapon`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | ---- | ---- | --- | +| 5r | arr | 五星武器的ID | | +| 4r | arr | 四星武器的ID | | \ No newline at end of file