Инструкция

Всё, что нужно, чтобы получить профиль: как передать ключ, какие параметры существуют, какие значения они принимают и что делать с ошибками. Общее описание сервиса — на странице «О сервисе».

Быстрый старт

Один GET-запрос, ключ в заголовке — и в ответе профиль целиком. Никаких предварительных вызовов, сессий и токенов.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://androidsystem.westernadv.ru/?getDev=samsung&getCountry=russia"

Всё остальное необязательно. Минимальный работающий запрос — только ключ: бренд, страна и оператор тогда выбираются случайно.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" "https://androidsystem.westernadv.ru/"

Как передать ключ

Два способа, оба рабочие. Заголовок предпочтительнее: ключ, переданный в адресе, оседает в логах веб-сервера, в реферере и в истории прокси — то есть в местах, доступных шире, чем сам сервис.

# рекомендуемый способ
X-Api-Key: ВАШ_КЛЮЧ

# работает для совместимости
https://androidsystem.westernadv.ru/?key=ВАШ_КЛЮЧ

Если заданы оба, приоритет у заголовка. Передавайте ключ ровно так, как он выдан: в параметре key лишние пробелы по краям значимы и дают Invalid API key — в заголовке они срезаются.

Параметры запроса

Все параметры необязательны и передаются в строке запроса. Неизвестные параметры игнорируются.

Чего выбрать нельзя

• Оператора. Он выбирается случайно среди операторов указанной страны. Управлять можно только страной.
• Город. Координаты задаются страной; выбрать конкретный регион внутри неё параметром нельзя.
• Название Wi-Fi-сети. Берётся случайно из общего списка и со страной не связано.
• Количество профилей за запрос. Один вызов — один профиль. Нужно сто — сто вызовов.

Страны

Значение для getCountry — из списка ниже. Именно оно определяет оператора, префикс номера телефона, координаты, часовой пояс и язык профиля. Всего 25 стран.

• argentina
• australia
• austria
• belgium
• brazil
• canada
• czech
• france
• germany
• india
• indonesia
• ireland
• italy
• japan
• kazakhstan
• mexico
• netherlands
• poland
• romania
• russia
• spain
• sweden
• uk
• ukraine
• usa

Операторы

Оператор выбирается случайно среди операторов указанной страны — задать его параметром нельзя. Здесь видно, какие операторы могут достаться профилю при том или ином значении getCountry. Всего 90 операторов.

Устройства

Раскройте бренд, чтобы увидеть его модели. Название бренда в заголовке блока — это значение для getDev. Всего 250 моделей от 18 производителей.

Модель и страна независимы: getDev=xiaomi прекрасно сочетается с любой страной из списка.

Ответ

Всегда application/json; charset=utf-8, 24 поля, порядок полей постоянный.

Пример ответа на запрос ?getDev=samsung&getCountry=russia&getCpu=8&getRam=8&getScrW=1080&getScrH=2340&getDpi=420

{
  "roProductBrand": "samsung",
  "roProductModel": "SM-S918B",
  "roHardware": "snapdragon8gen2",
  "IMEI": "354721887119926",
  "BluetoothMAC": "00:1E:52:B0:DD:6E",
  "MobileOperatorName": "mts",
  "MobileOperatorCode": "25001",
  "IMSI": "250010529749703",
  "ICCID": "89250016804016689534",
  "WifiName": "Hyrule",
  "Wifi": "4A:B2:6D:AC:03:0A",
  "MobilePhoneNumber": "+79136925491",
  "MobileCountry": "ru",
  "Latitude": "55.7145072",
  "Longitude": "37.5666733",
  "Timezone": "Europe/Moscow",
  "AndroidID": "7DF50337770A5C32",
  "MediaDrmDeviceID": "0EE2ABEB-CC7C-431E-94F5-052978C309B0",
  "CPU": 8,
  "RAM": 8192,
  "ScreenW": 1080,
  "ScreenH": 2340,
  "DPI": 420,
  "Language": "ru-RU"
}

Коды ответа

Ошибка приходит тем же JSON, в поле error; у части ошибок есть ещё поле message с пояснением. Ориентироваться надёжнее на HTTP-код, а не на текст.

Лимиты по умолчанию не выставлены: Rate limit exceeded и Daily limit exceeded приходят только тем ключам, для которых лимит согласован отдельно. Too many failed attempts от лимитов не зависит и защищает от перебора чужих ключей.

Примеры

Профиль конкретной модели

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://androidsystem.westernadv.ru/?getMod=КОД_МОДЕЛИ&getCountry=russia"

Флагманское железо, случайный бренд

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://androidsystem.westernadv.ru/?getCpu=8&getRam=8-12&getScrW=1080&getScrH=2340&getDpi=420"

Профиль с принудительной локалью

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://androidsystem.westernadv.ru/?getCountry=germany&getLanguage=en-US"

PHP

$ch = curl_init('https://androidsystem.westernadv.ru/?getDev=samsung&getCountry=russia');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Api-Key: ВАШ_КЛЮЧ']);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$profile = json_decode($body, true);
if ($status !== 200) {
    // $profile['error'] — что именно не так
}

Python

import requests

r = requests.get(
    "https://androidsystem.westernadv.ru/",
    headers={"X-Api-Key": "ВАШ_КЛЮЧ"},
    params={"getDev": "samsung", "getCountry": "russia"},
    timeout=15,
)
if r.status_code == 200:
    profile = r.json()
else:
    print(r.status_code, r.json().get("error"))

Если что-то не работает

Приходит Invalid API key, хотя ключ верный

Проверьте пробелы по краям и полноту ключа при копировании. Ключ передаётся ровно как выдан.

Все профили одной страны похожи

Так и задумано: страна задаёт часовой пояс, локаль и географию. Различаются идентификаторы, оператор, номер, модель и точные координаты.

Нужен профиль страны, которой нет в списке

Справочники пополняются — напишите, какая страна нужна.

Нужны тысячи профилей в сутки

Ограничений по умолчанию нет, запрашивайте сколько нужно. О больших объёмах всё же стоит предупредить: лимиты выставляются по фактическому потреблению, и лучше, если ваш реальный пик нам известен заранее.

Для связи и предложений

Вопросы по работе API, получение и продление ключа, пожелания к справочникам и новым параметрам: https://t.me/pautomatizer

Общее описание сервиса и состав данных — на странице «О сервисе».