API Utilitários - Documentação

Serviços de Rede

Consulta de IP

GET /meu-ip

Retorna o endereço IP público do cliente que fez a requisição.

Exemplo de resposta

{
  "ip": "123.45.67.89",
  "data_hora": "2023-06-15T14:30:00Z"
}

Segurança

Gerador de Senhas

GET /gerar-senha?tamanho=12&caracteres=todos

Gera senhas aleatórias seguras com opções de personalização.

Parâmetro	Tipo	Obrigatório	Descrição	Valores
tamanho	integer	Opcional	Tamanho da senha	Padrão: 12 (min: 6, max: 32)
caracteres	string	Opcional	Tipo de caracteres a incluir	letras, numeros, simbolos, todos (padrão: todos)

Exemplo de requisição

GET /gerar-senha?tamanho=16&caracteres=letras,numeros

Exemplo de resposta

{
  "senha": "AbcDefGhIjKlMnOp",
  "tamanho": 16,
  "caracteres_utilizados": ["letras", "numeros"],
  "forca": "forte"
}

Entretenimento

Perfil Netflix

GET /netflix-profile?nome=Convidado

Gera um perfil fictício no estilo Netflix com avatar e cor personalizada.

Parâmetro	Tipo	Obrigatório	Descrição
nome	string	Opcional	Nome do perfil (padrão: "Convidado")

Exemplo de resposta

{
  "id": 1,
  "nome": "Ulysses",
  "avatar": "https://loodibee.com/wp-content/uploads/Netflix-avatar-12.png",
  "cor": "#FFD700",
  "data_criacao": "2023-06-15T14:30:00Z"
}

Observação

O avatar é fixo no estilo Netflix. A cor do perfil é gerada automaticamente com base no nome fornecido.

Pagamentos

Gerador de QR Code PIX

POST /pix?chave=seuchave@pix.com&nome=SEU_NOME&valor=5.00&mensagem=Pagamento

Gera um QR Code PIX com payload e imagem em base64 para pagamentos instantâneos.

Parâmetro	Tipo	Obrigatório	Descrição	Limite
chave	string	Sim	Chave Pix (CPF, CNPJ, telefone, e-mail ou aleatória)	Até 140 caracteres
nome	string	Sim	Nome do recebedor	Até 25 caracteres
cidade	string	Sim	Cidade do recebedor	Até 15 caracteres
valor	string	Sim	Valor da transação (usar ponto como separador decimal)	Decimal positivo
mensagem	string	Não	Mensagem adicional no QR Code	Até 50 caracteres

Exemplo de requisição

{
  "chave": "16seuchave@pix.com",
  "nome": "Nickolas",
  "cidade": "BRASILIA",
  "valor": "44.50",
  "mensagem": "Pagamento"
}

Exemplo de resposta

{
  "status": "success",
  "message": "QR Code gerado com sucesso",
  "payload": "00020101021226360014br.gov.bcb.pix011416seuchave@pix.com5204000053039865445.005802BR598Nickolas608BRASILIA62130503Pagamento63047781",
  "qrcode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMQAAADECAYAAADApo5rAAAA...",
  "timestamp": "2023-06-15T14:30:00Z"
}

Como usar

Faça uma requisição POST para o endpoint /pix com os dados do pagamento
A API retornará o payload (texto do BR Code) e a imagem do QR Code em base64
Exiba a imagem no navegador com a tag <img src="..."> usando o valor de qrcode
Para pagamentos, o usuário pode escanear o QR Code com qualquer app de banco

Identificação

Identificador de Gênero

GET /genero?nome=Lucas

Detecta o provável gênero associado a um nome fornecido. Usa um modelo estatístico baseado em nomes comuns.

Parâmetro	Tipo	Descrição	Obrigatório
nome	string	Nome para o qual se deseja identificar o gênero	Sim

Exemplo de resposta

{
  "nome": "Lucas",
  "genero": "masculino",
  "probabilidade": 0.99
}

Observações

Este endpoint retorna apenas estimativas. Não é garantido que o gênero esteja correto para nomes unissex ou pouco comuns.

Futebol - Partidas Encerradas

Jogos de Futebol Finalizados

GET /futebol

Retorna uma lista de partidas de futebol que já ocorreram, incluindo informações detalhadas como placar, equipes, data e local.

Exemplo de resposta

{
  "data": [
    {
      "idEvent": "1032718",
      "strEvent": "Flamengo vs Palmeiras",
      "dateEvent": "2025-05-20",
      "strTime": "19:00:00",
      "strLeague": "Brasileirão Série A",
      "strHomeTeam": "Flamengo",
      "strAwayTeam": "Palmeiras",
      "intHomeScore": "2",
      "intAwayScore": "1",
      "strVenue": "Maracanã",
      "strStatus": "Match Finished"
    },
    {
      "idEvent": "1032719",
      "strEvent": "Manchester United vs Chelsea",
      "dateEvent": "2025-05-21",
      "strTime": "16:30:00",
      "strLeague": "Premier League",
      "strHomeTeam": "Manchester United",
      "strAwayTeam": "Chelsea",
      "intHomeScore": "1",
      "intAwayScore": "1",
      "strVenue": "Old Trafford",
      "strStatus": "Match Finished"
    }
  ]
}

Campo	Tipo	Descrição
idEvent	string	Identificador único da partida
strEvent	string	Descrição do evento (ex: Flamengo vs Palmeiras)
dateEvent	string	Data da partida (formato YYYY-MM-DD)
strTime	string	Horário de início da partida (formato HH:MM:SS)
strLeague	string	Nome da liga ou campeonato
strHomeTeam	string	Nome do time mandante
strAwayTeam	string	Nome do time visitante
intHomeScore	string	Gols do time mandante
intAwayScore	string	Gols do time visitante
strVenue	string	Estádio onde ocorreu a partida
strStatus	string	Status da partida (ex: Match Finished)

Nota

Os dados são atualizados diariamente e representam apenas jogos finalizados. (Em breve Melhorias).

Conversão de Moeda

Conversor de Moeda

GET /conversor?de=USD¶=BRL&valor=10

Converte um valor de uma moeda para outra com base nas cotações em tempo real.

Exemplo de resposta

{
  "de": "USD",
  "para": "BRL",
  "valor_original": "10",
  "cotacao": 5.02,
  "valor_convertido": "50.20"
}

Parâmetro	Tipo	Obrigatório	Descrição
de	string	Sim	Moeda de origem (ex: `USD`, `BRL`, `EUR`)
para	string	Sim	Moeda de destino (ex: `BRL`, `USD`)
valor	string ou número	Sim	Valor numérico a ser convertido

Nota

Limite de 10 requisições por minuto por IP. Os dados são baseados na cotação atual extraída do site do Banco Central.

Proxy CORS

CORS Proxy

GET /proxy?url=https://site.com/endpoint

Esta API serve como um proxy para contornar bloqueios de CORS (Cross-Origin Resource Sharing). Ela permite que você faça requisições para outros sites (APIs externas) que normalmente estariam bloqueadas no navegador por segurança.

É útil para frontend que precisa acessar uma API que não envia os cabeçalhos CORS corretos. O servidor da nossa API adiciona automaticamente os cabeçalhos:


Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET

Exemplo de uso


GET /proxy?url=https://jsonplaceholder.typicode.com/posts/1

Resposta (redirecionada e com CORS liberado):

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere...",
  "body": "quia et suscipit..."
}

Parâmetro	Tipo	Obrigatório	Descrição
url	string	Sim	URL completa do site ou API de destino. Deve começar com `http://` ou `https://`

Nota

Essa API não executa JavaScript dos sites de destino, apenas retorna o conteúdo bruto (HTML, JSON, etc). Se o site de destino precisa de execução de scripts para gerar conteúdo, isso não será refletido na resposta.

Fuso Horário

Consulta de Data/Hora

GET /datetime

Retorna a Data/Hora, Data e Hora.

Exemplo de resposta

{"datetime":"2025-08-05 02:58:17","date":"2025-08-05","time":"02:58:17"}