API DocumentationДокументация API
Welcome to the gsmarbot API. It provides direct access to specifications for over 12,000 mobile devices. Документация API gsmarbot. Сервис предоставляет прямой доступ к характеристикам более 12 000 мобильных устройств.
AuthenticationАутентификация
You need an API key to make requests. Pass it in the header. Для выполнения запросов требуется API-ключ. Передавайте его в заголовке.
Authorization: YOUR_API_KEY
Search DevicesПоиск устройств
Find devices by name. Fuzzy matching handles typos and transliterated queries. Поиск устройств по названию. Нечеткое сопоставление корректно обрабатывает опечатки и транслитерацию.
| ParamПараметр | TypeТип | InfoИнфо |
|---|---|---|
q |
Req |
Search query (e.g. iphone 15).
Поисковый запрос (например iphone 15).
|
curl "https://gsmarbot.ru/api/v1/search?q=pixel 8" -H "Authorization: KEY"
Get Device DetailsХарактеристики
Get full specifications for a specific device by internal ID or direct GSMArena URL. Полные характеристики устройства по внутреннему ID или прямой ссылке GSMArena.
| 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. Возвращает список последних проиндексированных или обновленных устройств.
| 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 - Превышен лимит запросов. |