API/Chinese - Revision history

1235789gzy1: Fix a typo

2024-04-01T01:59:50Z

Fix a typo

← Older revision		Revision as of 01:59, 1 April 2024
Line 12:		Line 12:
	用戶必須提供畫廊ID以及其令牌才能檢索畫廊元信息。這兩種信息都可以在畫廊的URL中找到，其格式如下：		用戶必須提供畫廊ID以及其令牌才能檢索畫廊元信息。這兩種信息都可以在畫廊的URL中找到，其格式如下：

	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki~~></pre~~>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki>

	舉例:訪問 https://e-hentai.org/g/2231376/a7584a5932/ 需要發送以下請求：		舉例:訪問 https://e-hentai.org/g/2231376/a7584a5932/ 需要發送以下請求：
Line 75:		Line 75:
	}		}
	]		]
	}</nowiki~~></pre~~>		}</nowiki>

	如果指定的令牌無效，則''gmetadata''~~數組中的條目醬油以下內容組成：~~		如果指定的令牌無效，則''gmetadata''數組中的條目將由以下內容組成：
	<pre<includeonly></includeonly> style="overflow: auto;~~{{{style\|}}}~~">{		<pre<includeonly></includeonly> style="overflow: auto;">{
	"gid":2231376,		"gid":2231376,
	"error":"Key missing, or incorrect key provided."		"error":"Key missing, or incorrect key provided."
Line 85:		Line 85:
	===畫廊令牌===		===畫廊令牌===
	單個頁面鏈接不能直接用於請求畫廊元信息。它們包含畫廊ID，但不包含畫廊令牌。''gtoken''方式可用於通過提供連接中的頁面數據來查找畫廊標記。頁面鏈接使用以下格式：		單個頁面鏈接不能直接用於請求畫廊元信息。它們包含畫廊ID，但不包含畫廊令牌。''gtoken''方式可用於通過提供連接中的頁面數據來查找畫廊標記。頁面鏈接使用以下格式：
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}</nowiki~~></pre~~>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}</nowiki>

	Example: https://e-hentai.org/s/40bc07a79a/618395-11 would require the following request:		Example: https://e-hentai.org/s/40bc07a79a/618395-11 would require the following request:

Lady Slayer: /* 畫廊元信息規範 */

2023-08-02T01:30:15Z

畫廊元信息規範

← Older revision		Revision as of 01:30, 2 August 2023
Line 112:		Line 112:
	! 元信息 !! 註釋		! 元信息 !! 註釋
	\|-		\|-
	\|*'''token''' \|\| 畫廊令牌		\|'''token''' \|\| 畫廊令牌
	\|-		\|-
	\|*'''archiver_key''' \|\| - [[Archiver/Chinese\|歸檔器]]的鑰匙串每小時都會變化，但是單個鑰匙串的有效時間期限是24小時。		\|'''archiver_key''' \|\| - [[Archiver/Chinese\|歸檔器]]的鑰匙串每小時都會變化，但是單個鑰匙串的有效時間期限是24小時。
	\|-		\|-
	\| '''posted''' \|\| - UNIX 時間戳, 使用協調世界時。		\|'''posted''' \|\| - UNIX 時間戳, 使用協調世界時。
	\|-		\|-
	\| '''filesize''' \|\| - 畫廊的大小，單位為bytes。		\|'''filesize''' \|\| - 畫廊的大小，單位為bytes。
	\|-		\|-
	\| '''tags''' \|\| - 畫廊標籤的字符串列表。除非可選的"namespace"參數設置為"1"，否則[[命名空間]]不會被包含在內。		\|'''tags''' \|\| - 畫廊標籤的字符串列表。除非可選的"namespace"參數設置為"1"，否則[[命名空間]]不會被包含在內。
	\|}		\|}

Lady Slayer: created and translated

2023-08-02T01:25:33Z

created and translated

New page

E-Hentai API 可用於請求[[畫廊]]的原始信息。這可用於鏈接畫廊或者單張圖片。

==概要==
*API URL: https://api.e-hentai.org/api.php
*請求方式: POST
*請求類別: JSON
*響應類別: JSON
*加載限制: 每次请求 25 个条目，通常可连续请求 4-5 次，然后需要等待 ~5 秒钟

==指令與響應==
===畫廊元信息===
用戶必須提供畫廊ID以及其令牌才能檢索畫廊元信息。這兩種信息都可以在畫廊的URL中找到，其格式如下：

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki></pre>

舉例:訪問 https://e-hentai.org/g/2231376/a7584a5932/ 需要發送以下請求：

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
"method": "gdata",
"gidlist": [
[2231376,"a7584a5932"]
],
"namespace": 1
}</pre>

響應的JSON有效載荷如下:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><nowiki>{
"gmetadata": [
{
"gid": 2231376,
"token": "a7584a5932",
"archiver_key": "459562--7e27d313c50099214fde6bf74f8014d9309a2bb8",
"title": "[Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing]",
"title_jpn": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中]",
"category": "Artist CG",
"thumb": "https://ehgt.org/1f/f5/1ff5e361bbf7eaa235e9560dc5d12e624959e9e7-2722367-1882-3000-jpg_l.jpg",
"uploader": "Pokom",
"posted": "1653702810",
"filecount": "329",
"filesize": 419547090,
"expunged": false,
"rating": "4.78",
"torrentcount": "2",
"torrents": [
{
"hash": "25198ccc3cd88393897aa5c630eb95d5ec4f695e",
"added": "1634958428",
"name": "(同人CG集) [ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中].zip",
"tsize": "12256",
"fsize": "310511523"
},
{
"hash": "62c960eb1c7a0e00dc2933a0c83dd43e2e6ebd48",
"added": "1639495362",
"name": "[Artist CG] Gentsuki - Kininaru Danshi ni 〇〇 suru Onnanoko (14 December 2021).zip",
"tsize": "27652",
"fsize": "357426803"
}
],
"tags": [
"artist:gentsuki",
"female:ponytail",
"female:schoolgirl uniform",
"female:stockings",
"female:swimsuit",
"female:tanlines",
"female:twintails",
"other:no penetration",
"other:nudity only"
],
"parent_gid": "2197090",
"parent_key": "2f440c5f01",
"first_gid": "2043548",
"first_key": "bdb0cd9ec2"
}
]
}</nowiki></pre>

如果指定的令牌無效，則''gmetadata''數組中的條目醬油以下內容組成：
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
"gid":2231376,
"error":"Key missing, or incorrect key provided."
}</pre>

===畫廊令牌===
單個頁面鏈接不能直接用於請求畫廊元信息。它們包含畫廊ID，但不包含畫廊令牌。''gtoken''方式可用於通過提供連接中的頁面數據來查找畫廊標記。頁面鏈接使用以下格式：
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><nowiki>https://e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}</nowiki></pre>

Example: https://e-hentai.org/s/40bc07a79a/618395-11 would require the following request:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
"method": "gtoken",
"pagelist": [
[618395,"40bc07a79a",11]
]
}</pre>

響應的JSON有效載荷如下:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
"tokenlist": [
{
"gid":618395,
"token":"0439fa3666"
}
]
}</pre>

如果任何輸入的內容有誤，用戶會受到"File not found"的錯誤訊息而不是那次輸入的令牌。

==畫廊元信息規範==

{| class="wikitable"
! 元信息 !! 註釋
|-
|*'''token''' || 畫廊令牌
|-
|*'''archiver_key''' || - [[Archiver/Chinese|歸檔器]]的鑰匙串每小時都會變化，但是單個鑰匙串的有效時間期限是24小時。
|-
| '''posted''' || - UNIX 時間戳, 使用協調世界時。
|-
| '''filesize''' || - 畫廊的大小，單位為bytes。
|-
| '''tags''' || - 畫廊標籤的字符串列表。除非可選的"namespace"參數設置為"1"，否則[[命名空間]]不會被包含在內。
|}

*''category'' - [[Gallery_Categories/Chinese|分類]]的名稱與網站上使用的略有不同，以下是它們在API中對應的名稱：
{| class="wikitable"
! 分類 !! 註釋
|-
| Doujinshi || [[Gallery_Categories/Chinese#同人誌|同人誌]]
|-
| Manga || [[Gallery_Categories/Chinese#漫畫|漫畫]]
|-
| Artist CG || [[Gallery_Categories/Chinese#藝術家CG|藝術家CG]]
|-
| Game CG || [[Gallery_Categories/Chinese#遊戲CG|遊戲CG]]
|-
| Western || [[Gallery_Categories/Chinese#西方|西方]]
|-
| Image Set || [[Gallery_Categories/Chinese#圖片集|圖片集]]
|-
| Non-H || [[Gallery_Categories/Chinese#無H|無H]]
|-
| Cosplay || [[Gallery_Categories/Chinese#角色扮演|角色扮演]]
|-
| Asian Porn || [[Gallery_Categories/Chinese|亞洲色情]]
|-
| Misc || [[Gallery_Categories/Chinese#多功能類|多功能類]]
|-
| Private || [[Gallery_Categories/Chinese#私人畫廊|私人畫廊]]
|}

==多重請求==
要獲取多個畫廊的元信息，用戶只需要在''gidlist''中添加條目即可。用戶在一次請求中最多可以添加25個條目。同樣的方式也適用於畫廊令牌但使用''pagelist''中的條目。

==參見==
*[https://forums.e-hentai.org/index.php?showtopic=157779 Gallery Filecount] - 一個使用API請求來為搜索結果添加信息的用戶腳本

{{ChineseEHGNav}}

[[Category:Chinese]]