Прошло 2 года с момента запуска Uni-Tools – сайта с различными сервисами и инструментами в сфере IT. К сожалению, в этот период я был очень занят работой, поэтому времени заниматься сайтом у меня почти не было. Тем не менее, хотя бы 3 новых инструмента и 2 новых сервиса я все же смог добавить. Время от времени мне в соц. сети писали люди, спрашивали про API, поэтому еще в 2023 году я слепил на коленке простенький самописный api (v1) в качестве эксперимента и предоставил ключи тем, кто просил, однако я всегда хотел сделать и запустить полноценный публичный API интерфейс и вчера это наконец случилось.
В меню сайта появился новый раздел – API. В этом разделе каждый может получить API ключ, а также ознакомиться с документацией по доступным методам и ценами на запросы. Там же находится личный кабинет, где можно сменить api ключ, пополнить баланс и ознакомиться со статистикой за последние 3 месяца. Кстати, документация максимально проработана, я отразил в ней все необходимые сведения для работы с каждым методом API: URL метода, необходимые заголовки запроса, JSON-ответы при успешном и неудачном запросе, примеры кода cURL, PHP и Python, а также возможные коды ошибок с описанием. Если вы авторизуетесь в личном кабинете, то в документации вместо YOUR_API_KEY будет подставлен ваш API-ключ, а также появится возможность опробовать методы прямо на сайте (а-ля swagger).
На момент запуска, API v2 имеет 4 метода:
- /phone/search – поиск оператора по номеру городского или мобильного телефона;
- /phone/mnp – поиск оператора по номеру мобильного телефона (с учетом MNP переносов);
- /mac/vendor – поиск производителя сетевого устройства по его MAC-адресу;
- /mac/location – поиск местоположения Wi-Fi устройства по его MAC-адресу;
Также реализован метод для проверки баланса API-ключа – его обычно используют для уведомлений о приближении баланса к нулю. Со временем я буду реализовывать новые методы.
Для того, чтобы API v2 мог стабильно работать при повышенной нагрузке, я перенес Uni-Tools на более производительный сервер, а также скорректировал настройки CloudFlare. Что касается пополнения баланса, мне очень не хотелось пользоваться услугами “серых” платежных систем, которые принимают платежи банковскими картами только посредством перевода (p2p), потому что это неудобно для конечного пользователя. Поэтому я зарегистрировался как самозанятый и подписал договор с сервисом ЮKassa, так что пополнять баланс можно через ЮMoney и привязанные там карты, а также через SberPay или просто с банковских карт.
И последнее, что я бы хотел сказать. Предыдущая версия API v1 перестанет работать с 1 июля, поэтому пользователям необходимо самостоятельно получить ключ для новой версии API и перейти на нее. Переход не отнимет у вас много времени. Для авторизации все так же используется один заголовок, просто теперь не “X-Api-Key”, а просто “Api-Key”. А у JSON с результатами немного изменилась структура, нужно лишь подстроиться под нее, а также убедиться, что вы обрабатываете в своем коде все нужные вам ошибки, их список указан в документации для каждого метода.
Жду вас в Uni-Tools API v2!
