Preciso saber programar?

Não. Você cola o prompt no chat do projeto e a Lovable escreve a função no servidor, a tela e o tratamento de erros. Seu trabalho é criar a conta, guardar a API key como segredo e testar com uma placa.

Por que a chamada precisa ficar no servidor?

A API key é secreta e cada chamada gasta o seu saldo. Se o app chamar a Simples API direto do navegador, a chave vai junto no código da página e qualquer visitante consegue copiá-la. Numa Edge Function ou server function, a chave fica num segredo do projeto e o navegador só fala com a sua função. O prompt já pede isso para a Lovable.

A função no servidor fica aberta?

Fica, se ninguém pedir login: ela tem um endereço público, e quem descobrir esse endereço consegue gastar o seu saldo pela função. Por isso o prompt pede que, num app com login, a função só atenda usuários logados. Num app sem login, ligue o alerta de saldo baixo e recarregue aos poucos.

Preciso do Lovable Cloud ou do Supabase?

Precisa de um backend para a função no servidor. Nos projetos em React com Vite, a Lovable usa uma Edge Function, que exige o backend da Lovable (Lovable Cloud) ou o Supabase ligado; se o projeto ainda não tiver, a Lovable oferece ligar. Nos projetos em TanStack Start, ela usa uma server function.

R$ 0,10 por consulta pela placa, com ou sem dados retornados. Na foto, R$ 0,05 por placa lida, mais R$ 0,10 quando o app pede os dados do veículo. Imagem sem placa lida, placa inválida e consulta indisponível não são cobradas. Ao criar a conta, você recebe R$ 5 em créditos grátis, sem cartão de crédito.

E se a minha chave vazar?

Gere uma nova API key no painel: a antiga para de funcionar na hora. Depois, atualize o segredo SIMPLES_API_KEY na Lovable com a chave nova. O saldo é pré-pago, então o gasto nunca passa do que você recarregou, e o alerta de saldo baixo avisa antes de acabar.

Funciona no Bolt, no v0 ou no Replit?

Sim. O prompt descreve a API e a regra de segurança sem depender da Lovable. Em qualquer construtor, confira que a chave ficou num segredo e que a chamada saiu de uma função no servidor.

Que dados a consulta traz?

Marca, modelo, versão, ano de fabricação e ano modelo, cor, combustível, tipo, espécie, cidade e UF de registro, entre outros. Não traz multas, débitos, restrições nem dados do proprietário.

Para apps feitos na Lovable

Consulta de placa no seu app com um prompt

Cole o prompt no chat da Lovable e o seu app passa a consultar veículos pela placa e a ler placas em fotos. A Lovable cria a função no servidor, guarda a API key como segredo e monta a tela. Serve também para Bolt, v0 e outros construtores de apps com IA.

1 prompt

para integrar

R$ 5

grátis para testar

R$ 0,10

por consulta

Começar com R$ 5 grátis Ver o prompt

Passo a Passo

Do cadastro ao app funcionando

Crie a conta

Cadastre-se, ganhe R$ 5 em créditos e copie a sua API key no painel.

Cole o prompt

Escolha abaixo a consulta pela placa ou pela foto e envie o prompt no chat do projeto.

Guarde a chave

Quando a Lovable pedir, cole a API key no formulário de segredo SIMPLES_API_KEY. Nunca no chat.

Teste na prévia

Digite uma placa ou tire uma foto. Cada chamada aparece no histórico do painel.

Prompt pronto

Copie e cole no chat da Lovable

O prompt não leva a sua chave. A Lovable vai pedir o segredo SIMPLES_API_KEY: cole a API key no formulário que ela mostrar, nunca no chat.

Consulta pela placa

Placa pela foto

O usuário digita a placa e o app mostra marca, modelo, ano, cor e cidade do veículo.

R$ 0,10 por consulta

Prompt para o chat da Lovable

Integre a Simples API ao app para consultar veículos pela placa. API
- Base URL: https://api.simplesapi.com.br
- Endpoint: POST /v1/vehicle/plate
- Autenticação: header Authorization: Bearer <API key>. A chave fica no segredo SIMPLES_API_KEY. Se ele ainda não existir, peça para eu adicioná-lo pelo formulário de segredos, nunca pelo chat.
- Corpo (JSON): {"plate": "ABC1D23"}. Aceita placas Mercosul e do formato antigo, com ou sem hífen.
- Resposta 200: {"plate": "ABC1D23", "vehicle_info": {"brand", "model", "version", "year", "model_year", "color", "fuel", "city", "state", ...}}
- Erros: o corpo traz "code" e "message"; mostre a "message" ao usuário. 404 VEHICLE_NOT_FOUND (placa sem dados), 422 VALIDATION_ERROR (placa inválida), 402 INSUFFICIENT_BALANCE (sem saldo), 429 RATE_LIMIT_EXCEEDED (muitas consultas seguidas), 503 VEHICLE_API_UNAVAILABLE (consulta indisponível).
- Documentação: https://simplesapi.com.br/llms.txt e https://api.simplesapi.com.br/openapi.json Segurança (obrigatório)
- Chame a Simples API só no servidor, numa Edge Function ou server function que lê o segredo SIMPLES_API_KEY. O frontend chama essa função, nunca a Simples API direto.
- A API key não pode aparecer no código do frontend nem voltar na resposta da função.
- Se o app tem login, a função só atende usuários logados: sem isso, qualquer pessoa que descobrir o endereço da função gasta o saldo da conta.
- Se a Simples API responder 403 BROWSER_API_KEY, a chamada saiu do navegador: mova-a para o servidor. Tela
- Um campo para a placa, um botão "Consultar" e um cartão com marca, modelo, versão, ano/modelo, cor, combustível e cidade/UF.
- Consulte só quando o usuário clicar em "Consultar" (cada consulta é cobrada), nunca enquanto ele digita.
- Mostre que está carregando durante a consulta e as mensagens de erro em português.

Segurança

A chave fica fora do navegador

A chave fica no servidor

O prompt pede uma Edge Function ou server function: o navegador fala com a sua função, e só ela fala com a Simples API.

Segredo, não código

A API key fica no segredo SIMPLES_API_KEY do projeto, fora do código da página e do histórico do chat.

Saldo pré-pago

O gasto nunca passa do que você recarregou, e o alerta de saldo baixo avisa antes de acabar.

Troque a chave quando quiser

Gere uma nova API key no painel e a antiga para de funcionar na hora.

Tudo no histórico

Cada chamada do app aparece no histórico de requisições do painel, com o status e o erro, quando houver.

Fotos não ficam guardadas

As fotos enviadas são processadas em memória e descartadas logo depois da leitura.

Aplicações

Casos de Uso

Oficinas

Abra a ordem de serviço com a foto da placa: marca, modelo, ano e motor já preenchidos.

Revenda de usados

Monte a ficha do carro pela placa na hora da avaliação, sem digitar os dados.

Estacionamentos e lava-rápidos

Registre a entrada e a saída pela foto da placa, com o modelo e a cor do carro.

Portaria de condomínio

Cadastre os carros de visitantes e prestadores pela placa, direto do celular.

Frotas e logística

Confira na foto se o veículo que chegou é o que estava agendado.

Vistorias e seguros

Confira na foto da vistoria se a placa e o modelo batem com o cadastro do cliente.

FAQ

Perguntas Frequentes

Comece agora com R$ 5 grátis

Crie sua conta, copie a API key e cole o prompt na Lovable. Sem cartão de crédito.

Criar conta grátis