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

Welcome to the gsmarbot API. It provides direct access to specifications for over 12,000 mobile devices. Документация API gsmarbot. Сервис предоставляет прямой доступ к характеристикам более 12 000 мобильных устройств.

Base URL: https://gsmarbot.ru/api/v1

AuthenticationАутентификация

You need an API key to make requests. Pass it in the header. Для выполнения запросов требуется API-ключ. Передавайте его в заголовке.

Authorization: YOUR_API_KEY
Get your keyГде взять ключ? Open @gsmarbot in Telegram and select "Create App". Откройте @gsmarbot в Telegram и выберите «Создать приложение».

Get Device DetailsХарактеристики

Get full specifications for a specific device by internal ID or direct GSMArena URL. Полные характеристики устройства по внутреннему ID или прямой ссылке GSMArena.

GET /device
ParamПараметр TypeТип InfoИнфо
id Opt* Internal Device ID (e.g. ab12cd). Внутренний ID (напр. ab12cd).
url Opt* Direct link to GSMArena page. Прямая ссылка на страницу GSMArena.

* You must provide either id or url. * Вы должны указать либо id, либо url.

Response ExampleПример ответа

{
  "success": true,
  "result": {
    "id": "abcd1234",
    "title": "Google Pixel 8",
    "screen": "6.2 inches, OLED, 120Hz",
    "cpu": "Google Tensor G3",
    "battery": "4575 mAh",
    "img": "https://..."
  }
}

Latest UpdatesОбновления

Returns a list of the most recently indexed or updated devices. Возвращает список последних проиндексированных или обновленных устройств.

GET /latest
ParamПараметр TypeТип InfoИнфо
limit Opt Result count (Default: 10, Max: 50). Кол-во результатов (По ум.: 10, Макс: 50).

ErrorsКоды ошибок

We use standard HTTP codes. Мы используем стандартные HTTP коды.

Code MeaningЗначение
200 OK - Request completed successfully.OK - Запрос выполнен успешно.
400 Bad Request - Missing or invalid parameter.Bad Request - Отсутствует или некорректен параметр.
401 Unauthorized - API key is missing.Unauthorized - API-ключ отсутствует.
403 Forbidden - Invalid API key.Forbidden - Некорректный API-ключ.
404 Not Found - Device not found.Not Found - Устройство не найдено.
429 Too Many Requests - Rate limit exceeded.Too Many Requests - Превышен лимит запросов.