API/Chinese

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

概要

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

指令與響應

畫廊元信息

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

https://e-hentai.org/g/{gallery_id}/{gallery_token}/

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

{
  "method": "gdata",
  "gidlist": [
      [2231376,"a7584a5932"]
  ],
  "namespace": 1
}
響應的JSON有效載荷如下:

{
    "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"
        }
    ]
}

如果指定的令牌無效，則gmetadata數組中的條目將由以下內容組成：
{
  "gid":2231376,
  "error":"Key missing, or incorrect key provided."
}
畫廊令牌
單個頁面鏈接不能直接用於請求畫廊元信息。它們包含畫廊ID，但不包含畫廊令牌。gtoken方式可用於通過提供連接中的頁面數據來查找畫廊標記。頁面鏈接使用以下格式：

https://e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}

Example: https://e-hentai.org/s/40bc07a79a/618395-11 would require the following request:
{
  "method": "gtoken",
  "pagelist": [
  [618395,"40bc07a79a",11]
 ]
}
響應的JSON有效載荷如下:

{
 "tokenlist": [
   {
    "gid":618395,
    "token":"0439fa3666"
   }
  ]
}
如果任何輸入的內容有誤，用戶會受到"File not found"的錯誤訊息而不是那次輸入的令牌。

畫廊元信息規範


元信息
註釋


token
畫廊令牌


archiver_key
- 歸檔器的鑰匙串每小時都會變化，但是單個鑰匙串的有效時間期限是24小時。


posted
- UNIX 時間戳, 使用協調世界時。


filesize
- 畫廊的大小，單位為bytes。


tags
- 畫廊標籤的字符串列表。除非可選的"namespace"參數設置為"1"，否則命名空間不會被包含在內。

category - 分類的名稱與網站上使用的略有不同，以下是它們在API中對應的名稱：


分類
註釋


Doujinshi
同人誌


Manga
漫畫


Artist CG
藝術家CG


Game CG
遊戲CG


Western
西方


Image Set
圖片集


Non-H
無H


Cosplay
角色扮演


Asian Porn
亞洲色情


Misc
多功能類


Private
私人畫廊

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

參見
Gallery Filecount - 一個使用API請求來為搜索結果添加信息的用戶腳本