Android Creator API
Сервис отдаёт по одному HTTP-запросу готовую конфигурацию Android-устройства: модель и железо, идентификаторы, мобильного оператора с номером телефона, координаты, часовой пояс и язык. Всё в одном JSON, всё согласовано между собой.
Задача, ради которой он сделан, — получать наборы параметров, которые выглядят как снятые с настоящего телефона, а не собранные генератором случайных чисел. Поэтому в основе не формулы, а справочники: настоящие модели устройств, настоящие мобильные операторы с их собственными кодами, настоящие диапазоны телефонных номеров и границы конкретных городов.
Сейчас в справочниках: 25 стран, 90 мобильных операторов, 250 моделей устройств от 18 производителей, 186 названий Wi-Fi-сетей и 63 географических региона. Полный перечень стран, операторов и моделей — на странице инструкции.
Что приходит в ответе
Один запрос — один профиль из 24 полей. Поля не независимы: оператор берётся под выбранную страну, SIM-карта — под выбранного оператора, префикс номера телефона, часовой пояс, язык и координаты тоже определяются страной.
| Группа | Поля |
|---|---|
| Устройство | Бренд, модель и аппаратная платформа так, как их сообщает сама система Android |
| Идентификаторы | IMEI, соответствующий выбранной модели, и идентификаторы, по которым устройство узнают приложения |
| SIM и оператор | Оператор указанной страны, данные его SIM-карты и номер телефона с местным префиксом |
| Сеть | Название точки доступа и MAC-адреса Wi-Fi и Bluetooth |
| Локация | Координаты внутри выбранной страны и соответствующие ей часовой пояс и язык |
| Железо | Число ядер, объём памяти, размер и плотность экрана — задаются параметрами запроса, в том числе диапазоном |
Точные имена параметров, значения по умолчанию и пример ответа — в инструкции.
Как это устроено
Один эндпоинт, обычный GET, ответ —
application/json. Ни SDK, ни библиотек, ни авторизации по
OAuth: достаточно того, чем умеет ходить в сеть любой язык и любой
инструмент автоматизации. Ключ доступа передаётся заголовком
X-Api-Key либо параметром в адресе — второй вариант оставлен
для совместимости с уже написанными интеграциями.
Состояния между запросами нет: каждый вызов независим, повторный запрос с теми же параметрами даёт другой профиль. Ограничений на то, как часто и откуда обращаться, по умолчанию нет — лимиты выставляются индивидуально и только по договорённости.
Доступ
Работа с сервисом идёт по ключу. У ключа есть срок действия; часть ключей выдаётся бессрочно. Когда срок вышел, сервис отвечает понятной ошибкой со ссылкой на продление, а не молча перестаёт работать, — так что заметить это в логах своей автоматизации несложно.
Получить ключ, продлить лицензию или обсудить нестандартный сценарий использования: https://t.me/pautomatizer.
Что сохраняется о запросах
Чтобы отвечать на вопрос «почему у меня перестало работать», сервис ведёт учёт обращений. Сохраняются: время, IP-адрес, код ответа, запрошенные бренд и страна, длительность обработки и первые восемь символов предъявленного ключа — целиком ключ в журнал не попадает никогда. Детальные записи хранятся 60 дней, дальше остаются только суточные счётчики без привязки к отдельным запросам.
Содержимое выданных профилей нигде не сохраняется: сервер не знает, какой именно IMEI или номер он вам отдал.
Дальше
Инструкция — все параметры запроса, полный список стран и операторов, перечень моделей, коды ошибок и готовые примеры вызова.