IB
Italian Brainrot Wiki

API文档

概述

Italian Brainrot Wiki API提供对我们角色数据库的程序化访问。所有API端点返回JSON数据并支持浏览器应用的CORS。

基础URL: https://italianbrainrot.wiki/api

端点

GET /api/characters

获取分页的角色列表

查询参数:

  • page - Page number (default: 1)
  • limit - Items per page (default: 20, max: 100)
  • sort - Sort by: popularity, name, recent (default: popularity)
  • type - Filter by character type
  • order - Sort order: asc, desc (default: desc)
GET /api/characters?page=1&limit=20&sort=popularity

GET /api/characters/:id

按ID获取单个角色

GET /api/characters/clm9xzw0x0000qw0xg6h7k9xy

GET /api/search

搜索角色

查询参数:

  • q - Search query
  • type - Filter by character type
  • popularity - Filter by popularity: high, medium, low
  • hasRelationships - Filter characters with relationships (true/false)
  • page - Page number (default: 1)
  • limit - Items per page (default: 20)
GET /api/search?q=tralalero&type=HYBRID_ANIMAL

GET /api/alphabet

按首字母获取角色

查询参数:

  • letter - Single letter A-Z or # for special characters (required)
GET /api/alphabet?letter=T

响应格式

所有API响应遵循一致的JSON格式：

{
  "characters": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 127,
    "totalPages": 7
  }
}

速率限制

API目前免费使用，无需身份验证。请尊重并避免过度请求。如有必要，我们保留在未来实施速率限制的权利。

需要帮助？

如果您对API有疑问或需要帮助，请通过以下方式联系我们 Twitter