Впервые столкнулись с API? Давайте разберем основы, которые вам нужно будет понять, прежде чем погрузиться в автоматизацию Multilogin X. 

API

API — это способ общения программ между собой. Он работает как мост между приложениями: одно приложение может попросить другое что-то сделать или отдать данные.

Представьте API как официанта в ресторане: вы делаете заказ — официант (API) передает его на кухню (сервер), а потом приносит вам еду (ответ). Просто и удобно!

Postman

Postman — популярный инструмент для тестирования, разработки и управления API-запросами. С Postman вы можете:

• Отправлять API-запросы. 
• Получать ответы в понятных форматах — например, в JSON. 
• Использовать API-токены для аутентификации. 
• Автоматизировать повторяющиеся задачи с помощью скриптов. 
• Сортировать запросы по коллекциям для удобства повторного использования.

Мы рекомендуем начать с Postman — он удобен для новичков и поможет вам освоить основы API без необходимости написания кода.

Запросы и ответы API

Запрос API похож на заказ еды в ресторане. Вы сообщаете кухне (API), что вы хотите, предоставляя конкретные данные (параметры). Кухня обрабатывает ваш запрос и отправляет обратно еду (ответ).

Запрос API обычно включает в себя:

• Эндпоинт (URL): куда вы отправляете свой запрос. 
• Метод: что вы хотите сделать (GET, POST, PUT, DELETE). 
• Заголовки: дополнительная информация, например, ваш токен API. 
• Текст: любые отправляемые вами данные, например, данные для входа.

📌 Пример: вы запрашиваете данные о погоде в Таллинне из API, и API отвечает текущей температурой и прогнозом.

GET https://api.weather.com/data?city=Tallinn

API-эндпоинты

Эндпоинт — это URL, куда попадает ваш API-запрос. Это как телефонный номер — вы набираете его, чтобы получить информацию или отправить команды.

📌 Пример в Postman:

• Запрос GET к эндпоинту: если вы отправите запрос GET https://launcher.mlx.yt:45001/api/v1/version в Postman, API вернет версию приложения.
• Запрос POST к эндпоинту: если вы отправите запрос POST на https://launcher.mlx.yt:45001/api/v2/profile/quick с данными пользователя, API запустит разовый профиль.

Типы HTTP-запросов

API используют типы HTTP запросов (также называемые методами) для указания типа необходимого действия.

📌 Пример:

• https://launcher.mlx.yt:45001/api/v1/version — это GET-запрос, поскольку он возвращает информацию.
• https://launcher.mlx.yt:45001/api/v2/profile/quick — это POST-запрос, который создает разовый профиль.

API-токены

API-токен — это как цифровой ключ, который позволяет вам безопасно получить доступ к API. Когда вы делаете запрос к API, вам нужно включить этот токен, чтобы система знала, кто вы и разрешено ли вам выполнять это действие.

📌 Пример: чтобы отправить новый запрос в Postman, сначала нужно скопировать токен API в поле авторизации:

Интерфейс командной строки (CLI)

CLI позволяет взаимодействовать с Multilogin X с помощью команд в терминале. Postman более нагляден, а CLI больше подходит для опытных пользователей.

📌 Например, используя cURL (распространенный инструмент CLI для запросов API), вы можете отправить запрос GET следующим образом:

curl -X GET "https://api.example.com/users" -H "Authorization: Bearer YOUR_API_TOKEN"

Лимиты RPM

API ограничивают количество запросов, которые вы можете отправить в минуту с помощью RPM (запросы в минуту). Лимит RPM в Multilogin зависит от типа подписки — подробности смотрите на странице цен.

• RPM показывает, сколько запросов вы можете отправить за одну минуту 
• Каждый раз, когда вы просите API выполнить что-либо (например, получить данные или обновить запись), это считается одним запросом.

📌 Пример: если ваш лимит составляет 100 RPM, вы можете отправлять до 100 запросов в минуту. Если вы достигли лимита, попробуйте подождать минуту или обновить свой план, чтобы отправлять больше запросов. 

Веб-драйверы

WebDriver — это инструмент, который позволяет автоматизировать взаимодействие с браузерами. Он управляет браузером так же, как это делает настоящий пользователь — нажимая кнопки, заполняя формы и перемещаясь по страницам. Multilogin X поддерживает интеграцию с Selenium, Puppeteer и Playwright, что позволяет выполнять такие задачи, как заполнение форм, решение CAPTCHA и веб-скрейпинг.

Selenium

Самым популярным веб-драйвером является Selenium, который работает с Chrome, Firefox и Edge: он позволяет автоматизировать работу с использованием Python, Java, JavaScript и C#.

📌 Пример кода Selenium WebDriver на Python:

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://example.com")
print(driver.title)
driver.quit()

Puppeteer

Puppeteer — это библиотека Node.js, разработанная Google, которая позволяет программно автоматизировать и контролировать Chrome и Chromium. Она предоставляет высокоуровневый API для взаимодействия с веб-страницами — нажатие кнопок, заполнение форм, извлечение данных, создание PDF-файлов и многое другое.

📌 Пример Puppeteer на JavaScript:

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: 'example.png' });
  await browser.close();
})();

Playwright

Playwright — это современный open-source-фреймворк автоматизации для веб-тестирования, разработанный Microsoft. Он позволяет программно управлять Chrome, Firefox и Edge.

📌 Пример Playwright на JavaScript:

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(await page.title());
  await browser.close();
})();