Documentação Lobby

Guia completo de integração com WhatsApp

Começando

Para começar a usar nossas APIs, você precisa:

  1. Criar uma conta na plataforma
  2. Obter suas credenciais de API
  3. Incluir o token de autenticação nas requisições

URL Base da API

https://apifacil.dev/api/v1

Autenticação

Todas as requisições devem incluir o token de autenticação no header: 

Authorization: seu_token_aqui

Exemplos de Requisição

cURL

curl -X GET "https://apifacil.dev/api/v1/cep/90230060" \
     -H "Authorization: seu_token_aqui"

PHP

$token = "seu_token_aqui";
                $curl = curl_init();
                curl_setopt_array($curl, [
                CURLOPT_URL => "https://apifacil.dev/api/v1/cep/90230060",
                CURLOPT_RETURNTRANSFER => true,
                CURLOPT_HTTPHEADER => [
                "Authorization: {$token}"
                ]
                ]);
                $response = curl_exec($curl);

Mantenha seu token em segurança e nunca compartilhe com terceiros. Em caso de comprometimento, gere um novo token imediatamente no painel.

Consulta CNPJ

GET /api/v1/cnpj/{cnpj}

Consulta dados de um CNPJ

Exemplo de requisição

curl https://apifacil.dev/api/v1/cnpj/12345678000199 \
-H "Authorization: seu_token"

Exemplo de resposta

{
  "error": false,
  "data": {
    "cnpj": "12345678000199",
    "razao_social": "EMPRESA EXEMPLO LTDA",
    "nome_fantasia": "EXEMPLO COMERCIO",
    "situacao_cadastral": "ATIVA",
    "data_situacao_cadastral": "01/01/2010",
    "motivo_situacao_cadastral": "Motivo Exemplo",
    "municipio": "PORTO ALEGRE",
    "capital_social": "1000000.00",
    "contatos": {
      "telefone1": {
        "formatado": "(51) 9999-9999",
        "sem_formatacao": "5199999999"
      },
      "telefone2": "* * * * *",
      "email": "exemplo@empresa.com"
    },
    "cnae_fiscal": {
      "principal": "CNAE Principal",
      "secundarias": [
        {
          "codigo": "123456",
          "descricao": "CNAE Secundária 1"
        },
        {
          "codigo": "654321",
          "descricao": "CNAE Secundária 2"
        }
      ]
    },
    "endereco": {
      "logradouro": "RUA EXEMPLO",
      "numero": "123",
      "complemento": "SALA 1",
      "bairro": "CENTRO",
      "cep": "90230060",
      "uf": "RS",
      "municipio": "PORTO ALEGRE"
    }
  }
}

Consulta CEP

GET /api/v1/cep/{cep}

Consulta dados de um CEP

Exemplo de requisição

curl https://apifacil.dev/api/v1/cep/90230060 \
-H "Authorization: seu_token"

Exemplo de resposta

{
  "error": false,
  "data": {
    "cep": "90230060",
    "logradouro": "Avenida Exemplo",
    "bairro": "Centro",
    "cidade": "Porto Alegre",
    "estado": "RS",
    "ibge": "4314902",
    "pais": "Brasil"
  }
}

Consulta de Placa

Endpoint para consultar informações de veículos através da placa. Os dados são obtidos através de scraping inteligente em três servidores diferentes, garantindo maior confiabilidade e completude das informações.

GET /api/v1/placa/{placa}/basica

Retorna informações detalhadas do veículo.

Exemplo de Requisição

curl -X GET "https://apifacil.dev/api/v1/placa/ABC1234/basica" \
     -H "Authorization: seu_token" \
     -H "Accept: application/json"

Parâmetros

Parâmetro Tipo Descrição
placa string Placa do veículo (7 caracteres)

Exemplo de Resposta

{
    "server_pf": {
        "fonte": "server_pf",
        "detalhes": {
            "marca": "FIAT",
            "modelo": "PALIO ELX",
            "importado": "NÃO",
            "ano": "****",
            "ano_modelo": "****",
            "cor": "VERMELHA",
            "potencia": "** CV",
            "combustivel": "GASOLINA",
            "chassi": "*****2089***",
            "passageiros": "*",
            "uf": "**",
            "municipio": "*****"
        },
        "ipvas": [],
        "fipe": {
            "codigo_fipe": "******-*",
            "modelo_fipe": "PALIO ELX 1.0",
            "valor_fipe": "R$ **.*****"
        }
    }
}

Possíveis Erros

Código Descrição
400 Placa inválida
404 Placa não encontrada
500 Erro interno ao consultar placa

Observações Importantes:

  • A consulta é limitada por IP e token de acesso
  • Alguns dados podem estar mascarados por questões de privacidade
  • O serviço está disponível 24/7, mas pode haver limitações de horário para consultas em massa
  • A consulta é realizada simultaneamente em 3 servidores diferentes através de webscraping com IA
  • Os resultados são combinados para fornecer as informações mais completas possíveis
  • Por estar em versão beta, o serviço está em constante evolução e melhorias
  • A consulta é realizada através de webscraping com Inteligência Artificial, podendo levar até 30 segundos
  • Consultas subsequentes à mesma placa são retornadas instantaneamente do cache do sistema