Документация API

Обзор

API Italian Brainrot Wiki предоставляет программный доступ к нашей базе данных персонажей. Все конечные точки 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