Рассмотрим 10 API, которые понадобятся для решения повседневных задач. Сначала ознакомимся с терминологией API и разберём виды инструментов.
Чтобы ваша программа взаимодействовала с API:
-
Откройте любой из сервисов, предоставляющий программный интерфейс.
-
Зарегистрируйтесь и авторизуйтесь.
-
Свяжите написанное вами приложение с API.
-
Отошлите запрос и получите ответ.
Если ответ равен коду 200, что означает «Успех», вы можете распространять приложение между пользователями.
Какие бывают типы API
Существует несколько видов API:
-
API endpoint — конечные точки запроса. Обычно это URL-адреса.
-
API resources. Информация, полученная в ответ на запрос приложения.
-
API Keys. Уникальные идентификаторы.
-
API Calls. Запросы клиента к программному интерфейсу. Они состоят из эндпоинта, HTTP-запроса, заголовка и уникального идентификатора программного интерфейса.
Разработчики классифицируют API по степени доступа:
-
Частные. Их используют внутри компании
-
Партнёрские. Их предоставляют компаниям-партнёрам
-
Общедоступные. Их используют практически все разработчики
ТОП-10 API для разработчика
Мы подобрали сервисы, которые вы сможете использовать во время разработки приложений, сайтов и программ.
Common Crawl
Common Crawl собирает информацию со всего мира и архивирует веб-страницы для создания единой библиотеки.
Это интересно! Организация, создавшая этот API, выложила в общий доступ около пяти миллиардов веб-страниц в конце нулевых годов. Организаторы компании считали, что это приведёт к появлению множества инновационных веб-сервисов.
Как можно использовать Common Crawl:
-
обучение ML-моделей и проведение исследования
-
разработка новых поисковых систем и инструментов для анализа контента
-
изучение структуры и динамики сети
-
обогащение контента
Пример эндпоинтов Common Crawl:
-
index.commoncrawl.org/collinfo — для получения информации о доступных коллекциях данных;
-
index.commoncrawl.org/collinfo/collection_name — для получения информации о конкретной коллекции данных;
-
index.commoncrawl.org/collinfo/collection_name?url=url_pattern — для поиска записей по URL-шаблону в конкретной коллекции.
API WordPress
WP Rest API — плагин для разработчиков WordPress. Он позволяет администраторам переключать видимость и настраивать конечные точки для всех основных и пользовательских типов записей с помощью графического интерфейса. Вы сможете настроить видимость и метаданные, прикреплённые к ответу API.
С чем работать программисту в WP Rest API:
-
включать и отключать конечные точки REST API для типов сообщений и таксономий
-
включать и отключать метаданные
-
переименовывать конечные точки записи и БД
-
переименовывать имена метаданных для удобства пользователя
-
контролировать сообщения и их данные, полученные от сторонних плагинов и тем
-
контролировать ответы API без написания единой строки PHP-кода
-
включать фильтры для изменения и расширения функциональности
-
включать локализацию и готовность к переводам
Пример конечных точек REST API Wordpress:
-
wp-json/wp/v2/posts — для получения списка записей
-
wp-json/wp/v2/pages — для получения списка страниц
-
wp-json/wp/v2/media — для получения списка медиафайлов
-
wp-json/wp/v2/users — для получения списка пользователей
-
wp-json/wp/v2/comments — для получения списка комментариев
HeadHunter API
У компании HeadHunter есть открытый API. С помощью него можно анализировать и проверять примерно 400 тысяч живых вакансий и более миллиона архивных.
Возможности API:
-
размещение блока с вакансиями компании на сайте организации
-
получение информации по соискателям и работодателям
-
доступ к информации без получения и хранения логина и пароля пользователя
-
ранжирование результатов подбора персонала из базы резюме по различным критериям
Примеры запросов к API HeadHunter:
-
GET /vacancies — получение списка вакансий с использованием различных параметров фильтрации, таких как ключевые слова, город, опыт работы и др.
-
GET /vacancies/{vacancy_id} — получение подробной информации о конкретной вакансии по её идентификатору.
API PlaceKitten
Вам нужны забавные заглушки для тестирования приложений, которые работают с изображениями? Смело интегрируйте свой сайт или программу с API Place Kitten.
Вы получите изображение котёнка, если сделаете запрос с указанием размера изображения в URL.
Пример запроса: placekitten.com/200/300.
Система выдаст вам изображение шириной 200 и высотой 300 пикселей.
Используйте его, если хотите добавить немного юмора в разработку и тестирование приложений.
Внимание: API Place Kitten не распространяет фотографии настоящих кошек. Изображения сгенерированы нейросетями.
API «Яндекс Карт»
API «Яндекс Карт» — это набор функций для работы с картографическими данными. Интегрируйте интерактивные карты, маршрутизацию, геокодирование в сайты и приложения, которые разрабатываете.
Пользователи смогут находить нужные места, просчитывать маршруты, а вы — интегрировать в карты собственные геоданные.
Для работы с «Яндекс Картами» нужно получить ключ API. Для этого зарегистрируйтесь в личном кабинете разработчика сервиса, создайте новое приложение и выберите API «Яндекс Карт» для интеграции.
Теперь вы сможете использовать его в коде для установки карт от компании «Яндекс».
Примеры эндпоинтов для «Яндекс Карт»:
-
geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=37.611347,55.760241&... — запрос по координатам дома.
-
geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Масква&format=json — запрос города с опечаткой.
«ЮMoney» API
«ЮMoney» API предоставляет возможности для обработки платежей, управления счетами и других финансовых операций. Программный интерфейс имеет два сервиса:
-
для электронного кошелька
-
для виджетов и кнопок
Интерфейс кошелька помогает проводить приём денежных средств пользователей на вашем сайте. API поддерживает рекуррентные платежи и интеграцию с корзинами покупок.
Маркетплейсы при работе с этим API получат возможность фискализации.
Вы также сможете добавить на сайт функцию сбора денег, создавать платёжные виджеты со своим дизайном и получать HTTP-сообщения о входящих переводах.
Примеры endpoints «ЮMoney»:
-
api.yookassa.ru/v3/checkout/create — создание платёжной формы;
-
api.yookassa.ru/v3/transactions/{transaction_id} — получение информации о транзакции;
-
api.yookassa.ru/v3/account — получение информации о балансе кошелька.
МТС Exolve API
Exolve API — это программный интерфейс для облачной платформы МТС Exolve. Его используют для автоматизации коммуникаций разных сфер бизнеса. Инструменты, которые предлагает сервис для работы:
- sms api, voice api
-
call-tracking
-
callback api
-
модули авторизации и верификации
- и многие другие функции
Из преимуществ использования API отмечают гибкость и адаптацию к индивидуальным потребностям клиента. Сервис предлагает все опции для интеграции с инструментами digital-маркетинга. Ежемесячно компания совершенствует свои услуги и предлагает сообщество для обсуждения ошибок, новых функций и идей.
Плюсы для разработчика:
-
тестовый периода
-
форум, где общаются и делятся мнениями специалисты
-
понятная документация для мгновенного внедрения всех необходимых функций
Примеры endpoints Exolve API:
-
api.exolve.ru/callback/v1/Create — создание ресурса обратного звонка в личном кабинете
-
api.exolve.ru/call/v1/MakeCallback — совершение обратного звонка
Kaiten API
Ещё один инструмент для управления задачами компании — полностью русифицированный сервис Kaiten API. Программный интерфейс практически не содержит ошибок, а значит, стабильно работает. Вы можете интегрировать API со своим сайтом для улучшения коммуникаций. Этот сервис более гибкий, чем Jira.
В бесплатной версии Kaiten есть все функции, которые в Jira оплачиваются дополнительно:
-
отчёты
-
база знаний
-
хранилище данных без ограничений
Kaiten позволяет сайту или приложению получать обновления в режиме реального времени. Множество библиотек и SDK для разных языков программирования улучшает интеграцию и упрощает аутентификацию.
Используя Kaiten API, вы сможете связать свой сайт или приложение с продуктами МТС Exolve. Это оптимизирует работу менеджеров компании и улучшает взаимодействие с клиентами.
Примеры запросов к Kaiten API:
-
example.kaiten.ru/api/latest/spaces — создание нового пространства
-
example.kaiten.ru/api/latest/boards/{board_id}/columns — создание нового столбца
MuleSoft API
Mulesoft API упрощает процесс взаимодействия между различными системами через платформу AnyPoint.
Mulesoft API умеет:
-
преобразовывать данные из одного формата в другой
-
отслеживать производительность ваших API и их интеграций
-
обеспечивать аутентификацию, авторизацию и шифрование данных
Программный интерфейс MuleSoft даёт возможность управлять жизненным циклом ваших API. На платформе AnyPoint вы найдёте инструменты, с помощью которых легко создать собственные API или использовать уже готовые решения.
Вступив в открытое сообщество разработчиков MuleSoft API, вы получите поддержку опытных программистов и документацию для изучения возможностей этого интерфейса.
Примеры запросов к MuleSoft API:
-
SELECT * FROM employees WHERE department='IT' — обращение к базе данных MuleSoft API для выполнения SQL-запроса.
GISMeteo API
С помощью GisMeteo API вы получите последние данные о погоде. Если вы создаёте сайт города или области, то сможете привязать геолокацию вашего населённого пункта через API к своему сайту. Пользователи всегда будут в курсе достоверной информации о погоде.
Эндпоинты запросов по координатам:
-
api.gismeteo.net/v2/weather/current/?latitude=54.35&longitude=52.5.
Поиск ID географического объекта:
-
api.gismeteo.net/v2/weather/current/4368/.
Выбор языка:
-
api.gismeteo.net/v2/weather/current/4368/?lang=en.
Код для интеграции GisMeteo с вашим сайтом или приложением:
CREATE PROCEDURE [dbo].[fm_watch_gismeteo_saveItem]
@username nvarchar(256),
@itemID int,
@fieldcity nvarchar(256) = ''
AS
BEGIN
-- 1 SELECT (Result, Msg)
select 1 Result, ' ' Msg
select 'apirequest' type, 'gismeteo-cities' code, 'city' p1_name, @fieldcity p1_value
END
Заключение
Мы познакомили вас с эффективными на сегодняшний день API для разработчиков сайтов и приложений. Выбирайте тот, который подойдет для вашей деятельности.