Novo em API? Não se preocupe! Vamos detalhar os conceitos básicos que você precisa entender antes de se aprofundar na API do Multilogin X

API

Uma API (Interface de Programação de Aplicativos) é uma maneira de diferentes aplicativos de software se comunicarem entre si. Ela atua como uma ponte que permite que um sistema solicite e troque dados com outro.

Pense nas API como mensageiros digitais que transmitem solicitações entre aplicativos, tornando os fluxos de trabalho mais fluidos e rápidos. Uma analogia comum no mundo real é a de um garçom em um restaurante (API) que traz a você (o usuário) a refeição que você pediu (resposta à sua solicitação).

Carteiro

O Postman é uma ferramenta popular usada para testar, desenvolver e gerenciar API. Com o Postman, você pode:

• Enviar solicitações API
• Veja as respostas em formatos claros como JSON
• Use tokens API para autenticação
• Automatize tarefas repetitivas com scripts
• Organize suas solicitações em coleções para fácil reutilização

Recomendamos começar com o Postman – ele é fácil para iniciantes e ajuda você a aprender noções básicas API sem precisar codificar.

Solicitações e respostas API

Uma solicitação API é como pedir comida em um restaurante. Você informa à cozinha ( API ) o que deseja, fornecendo detalhes específicos (parâmetros). A cozinha processa sua solicitação e envia a refeição de volta (resposta).

Uma solicitação API geralmente inclui:

• Ponto final (URL): para onde você envia sua solicitação
• Método: o que você quer fazer (GET, POST, PUT, DELETE)
• Cabeçalhos: informações extras, como seu token API
• Corpo: quaisquer dados que você enviar, como detalhes de login

📌 Exemplo: você solicita dados meteorológicos em Tallinn de uma API , e a API responde com a temperatura atual e a previsão.

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

Pontos de extremidade API

Um endpoint é uma URL para onde sua solicitação API chega. Pense nele como um número de telefone: você disca para obter informações ou enviar comandos.

📌 Exemplo no Postman:

• Solicitação GET para um endpoint : se você enviar uma solicitação GET https://launcher.mlx.yt:45001/api/v1/version no Postman e clicar em "Enviar", a API fornecerá a versão do aplicativo.
• Solicitação POST para um endpoint : se você enviar uma solicitação POST para https://launcher.mlx.yt:45001/api/v2/profile/quick com detalhes do usuário no corpo, a API iniciará um perfil rápido

No Postman, basta colar a URL do endpoint e clicar em "Enviar" para testar.

Tipos de solicitação HTTP

API usam tipos de solicitação HTTP (também chamados de métodos) para especificar o tipo de ação necessária.

📌 Exemplo:

• https://launcher.mlx.yt:45001/api/v1/version é uma solicitação GET , pois retorna informações
• https://launcher.mlx.yt:45001/api/v2/profile/quick é uma solicitação POST , pois cria um novo perfil rápido

Tokens API

Um token API é como uma chave digital que permite acessar uma API com segurança. Ao fazer uma solicitação à API , você precisa incluir esse token para que o sistema saiba quem você é e se você tem permissão para executar a ação.

Pense nisso como um cartão-chave de hotel. Sem ele, você não consegue entrar no seu quarto (acesse a API ).

📌 Exemplo: para enviar uma nova solicitação no Postman, primeiro você precisa copiar um token API para o campo de autorização para autenticar:

Interface de linha de comando ( CLI )

CLI permite que você interaja com Multilogin X usando comandos no seu terminal – sem a necessidade de cliques! CLI é ótima se você gosta de digitar comandos ou quer criar scripts. O Postman é mais visual, CLI é mais para usuários avançados.

📌 Por exemplo, usando cURL (uma ferramenta CLI comum para solicitações API ), você pode enviar uma solicitação GET como esta:

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

Limites de taxa

API limitam quantas solicitações você pode enviar por minuto – isso é chamado de limitação de taxa , medida em RPM (solicitações por minuto). O limite de RPM Multilogin depende do tipo de assinatura – verifique a página de preços para obter detalhes.

• O RPM informa quantas solicitações você pode enviar em um minuto
• Cada vez que você solicita à API para fazer algo (como buscar dados ou atualizar um registro), isso conta como uma solicitação

📌 Exemplo: se o seu limite for de 100 RPM, você poderá enviar até 100 solicitações por minuto. Se atingir o limite, tente esperar um minuto ou atualizar seu plano para enviar mais solicitações!

Drivers da Web

Um WebDriver é uma ferramenta que permite interação automatizada com navegadores da web. Ele controla o navegador da mesma forma que um usuário real faria – clicando em botões, preenchendo formulários e navegando por páginas. Multilogin X suporta integração com bibliotecas de automação como Selenium, Puppeteer e Playwright, permitindo tarefas como preenchimento de formulários, resolução de CAPTCHA e web scraping.

Selenium

O WebDriver mais popular é Selenium, que funciona com navegadores como Chrome , Firefox e Edge: ele permite automação usando linguagens de programação como Python, Java, JavaScript e C#.

📌 Exemplo de código Selenium WebDriver em Python:

from selenium import webdriver

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

Puppeteer

Puppeteer é uma biblioteca Node.js desenvolvida pelo Google que permite automatizar e controlar navegadores como Chrome e Chromium programaticamente. Ela fornece uma API de alto nível para interagir com páginas da web – clicando em botões, preenchendo formulários, extraindo dados, gerando PDFs e muito mais.

📌 Exemplo Puppeteer em 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 é um framework de automação moderno e de código aberto para testes web, desenvolvido pela Microsoft. Ele permite controlar navegadores como Chrome, Firefox e Edge programaticamente, como um usuário real.

📌 Exemplo Playwright em 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();
})();