ScreenScraper WebAPI v2 文档（中文翻译）#

什么是「线程」？#

某些抓取软件（如 Universal XML Scraper）允许您同时处理多个 ROM，而不是逐个处理，从而节省抓取时间。

同时抓取的数量就是所谓的「线程」。

例如，拥有 4 个线程意味着您可以同时抓取 4 个 ROM，这将大大节省时间。

但请注意，这会占用更多计算机资源和带宽，尤其是会更多地访问数据库和服务器。

因此，我们建立了「奖励」系统。为了感谢您为 ScreenScraper 数据库做出的贡献，我们为您提供更高效的资源使用权限。

如何获得更多「线程」？#

有两种简单的方法：

• 通过提交新信息或新媒体资源参与数据库建设
• 通过 Tipee 或 Patreon 资助数据库托管费用

我可以获得多少「线程」？#

请查阅常见问题了解更多信息。

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• output：xml（默认）或 json

返回元素#

项目：serveurs（ScreenScraper 服务器信息）

• cpu1：服务器 1 的 CPU 使用率（过去 5 分钟平均值）
• cpu2：服务器 2 的 CPU 使用率（过去 5 分钟平均值）
• cpu3：服务器 3 的 CPU 使用率（过去 5 分钟平均值）
• threadsmin：自上次分钟以来的 API 访问次数
• nbscrapeurs：自上次分钟以来使用 API 的抓取器数量
• apiacces：当天（GMT+1）的 API 访问次数

状态

• closefornomember：API 是否对匿名用户关闭（0：开放 / 1：关闭）
• closeforleecher：API 是否对未参与贡献的会员关闭（0：开放 / 1：关闭）

配额

• maxthreadfornonmember：匿名用户最大同时线程数
• threadfornonmember：匿名用户当前线程数
• maxthreadformember：会员最大同时线程数
• threadformember：会员当前线程数

调用示例#

1
https://api.screenscraper.fr/api2/ssinfraInfos.php?devid=xxx&devpassword=yyy&softname=zzz&output=xml

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• output：xml（默认）或 json
• ssid：ScreenScraper 用户 ID
• sspassword：ScreenScraper 用户密码

返回元素#

项目：ssuser（ScreenScraper 用户信息）

• id：用户昵称
• numid：用户数字 ID
• niveau：用户等级
• contribution：资金贡献等级（2 = 1 个额外线程 / 3 及以上 = 5 个额外线程）
• uploadsysteme：用户提交的有效系统媒体计数
• uploadinfos：用户提交的有效文本信息计数
• romasso：用户提交的有效 ROM 关联计数
• uploadmedia：用户提交的有效游戏媒体计数
• propositionok：版主通过的建议数量
• propositionko：版主拒绝的建议数量
• quotarefu：建议拒绝百分比

线程

• maxthreads：允许的线程数
• maxdownloadspeed：允许的下载速度（KB/s）

配额

• requeststoday：当天 API 调用总数
• requestskotoday：返回负面结果的 API 调用数
• maxrequestspermin：每分钟最大 API 调用数
• maxrequestsperday：每天最大 API 调用数
• maxrequestskoperday：每天返回负面结果的最大 API 调用数
• visites：访问次数
• datedernierevisite：最后访问日期（格式：yyyy-mm-jj hh:mm）
• favregion：偏好区域（france, europe, usa, japon）

调用示例#

1
https://api.screenscraper.fr/api2/ssuserInfos.php?devid=xxx&devpassword=yyy&softname=zzz&output=xml&ssid=&sspassword=

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• output：xml（默认）或 json
• ssid（非必填）：ScreenScraper 用户 ID
• sspassword（非必填）：ScreenScraper 用户密码

返回元素#

项目：systeme（xml）/ systemes（json）

• id：系统数字 ID
• parentid：父系统数字 ID
• noms：按区域的系统名称
• extensions：可用的 ROM 文件扩展名
• compagnie：生产公司名称
• type：系统类型（Arcade, Console, Console Portable, Emulation Arcade, Flipper, Online, Ordinateur, Smartphone）
• datedebut：生产开始年份
• datefin：生产结束年份
• romtype：ROM 类型
• supporttype：原始支持类型
• medias：系统媒体（logo、wheel、照片、视频、bezel、背景等）

调用示例#

1
https://api.screenscraper.fr/api2/systemesListe.php?devid=xxx&devpassword=yyy&softname=zzz&output=XML&ssid=test&sspassword=test

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• output：xml（默认）或 json
• ssid（非必填）：ScreenScraper 用户 ID
• sspassword（非必填）：ScreenScraper 用户密码
• crc：ROM/ISO/文件夹的 CRC 校验值
• md5：ROM/ISO/文件夹的 MD5 校验值
• sha1：ROM/ISO/文件夹的 SHA1 校验值
• systemeid：系统数字 ID
• romtype：ROM 类型（单个 ROM 文件 / 单个 ISO 文件 / 文件夹）
• romnom：文件名（含扩展名）或文件夹名
• romtaille：文件或文件夹的大小（字节）
• serialnum：使用序列号强制搜索游戏
• gameid：使用游戏数字 ID 强制搜索

返回元素#

项目：jeu

• id：游戏数字 ID
• romid：ROM 数字 ID
• notgame：（true/false）指示 ROM 是否被分配到非游戏（demo/应用等）
• nom：游戏名称
• noms：按区域的游戏名称
• cloneof：克隆 ID
• systeme：系统信息
• editeur：发行商名称
• developpeur：开发商名称
• joueurs：玩家数量
• note：评分（满分 20）
• synopsis：按语言的游戏描述
• classifications：游戏分级
• dates：按区域的发布日期
• genres：游戏类型
• modes：游戏模式
• familles：游戏系列
• themes：游戏主题
• styles：游戏风格
• medias：游戏媒体（截图、同人、视频、wheel、包装盒、支持、传单、手册、bezel）
• roms：已知 ROM 列表

调用示例#

1
https://api.screenscraper.fr/api2/jeuInfos.php?devid=xxx&devpassword=yyy&softname=zzz&output=xml&ssid=test&sspassword=test&crc=50ABC90A&systemeid=1&romtype=rom&romnom=Sonic%20The%20Hedgehog%202%20(World).zip&romtaille=749652

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• output：xml（默认）或 json
• ssid（非必填）：ScreenScraper 用户 ID
• sspassword（非必填）：ScreenScraper 用户密码
• systemeid（非必填）：系统数字 ID
• recherche：要搜索的游戏名称

调用示例#

1
https://api.screenscraper.fr/api2/jeuRecherche.php?devid=xxx&devpassword=yyy&softname=zzz&output=xml&ssid=test&sspassword=test&systemeid=1&recherche=sonic

输入参数#

• devid：您的开发者 ID
• devpassword：您的开发者密码
• softname：调用软件名称
• ssid（非必填）：ScreenScraper 用户 ID
• sspassword（非必填）：ScreenScraper 用户密码
• crc：本地图片的 CRC 校验值
• md5：本地图片的 MD5 校验值
• sha1：本地图片的 SHA1 校验值
• systemeid：系统数字 ID
• jeuid：游戏数字 ID
• media：要返回的媒体文本 ID

输出参数#

• maxwidth（非必填）：返回图片的最大宽度（像素）
• maxheight（非必填）：返回图片的最大高度（像素）
• outputformat（非必填）：返回图片格式：png 或 jpg

返回元素#

• PNG 图片
• 或文本 CRCOK / MD5OK / SHA1OK（如果与服务器相同）
• 或文本 NOMEDIA（如果未找到）

调用示例#

1
https://api.screenscraper.fr/api2/mediaJeu.php?devid=xxx&devpassword=yyy&softname=zzz&ssid=test&sspassword=test&crc=&md5=&sha1=&systemeid=1&jeuid=3&media=wheel-hd(wor)