curl · bash · OCR

Gerador de Placa Mercosul via curl

A API REST do FakeForge gera placa Mercosul (LLLNLNN) e formato antigo (LLL-NNNN) direto via curl, conforme a Resolução CONTRAN 729/2018. Sem letras I, O ou Q. Útil pra popular pipeline de teste de OCR e ALPR sem SDK.

TL;DR

curl "https://fakeforge.com.br/api/generate?type=placa&quantity=100"

Rota 1: API REST oficial

# 5 placas Mercosul
curl "https://fakeforge.com.br/api/generate?type=placa&quantity=5"
# {"type":"placa","quantity":5,"data":["ABC1D23","XYZ9K45",...]}

# Placa no formato antigo
curl "https://fakeforge.com.br/api/generate?type=placaAntiga&quantity=5"

# CSV
curl "https://fakeforge.com.br/api/generate?type=placa&quantity=100&format=csv"

# SQL
curl "https://fakeforge.com.br/api/generate?type=placa&quantity=100&format=sql"

Rota 2: algoritmo local em bash (offline)

#!/usr/bin/env bash
# placa.sh - gera placa Mercosul localmente, sem API

LETRAS=(A B C D E F G H J K L M N P R S T U V W X Y Z)  # sem I, O, Q

gerar_placa_mercosul() {
  local l1=${LETRAS[$((RANDOM % ${#LETRAS[@]}))]}
  local l2=${LETRAS[$((RANDOM % ${#LETRAS[@]}))]}
  local l3=${LETRAS[$((RANDOM % ${#LETRAS[@]}))]}
  local d1=$((RANDOM % 10))
  local l4=${LETRAS[$((RANDOM % ${#LETRAS[@]}))]}
  local d2=$((RANDOM % 10))
  local d3=$((RANDOM % 10))
  echo "$l1$l2$l3$d1$l4$d2$d3"
}

for i in $(seq 1 10); do
  gerar_placa_mercosul
done

Testes de OCR/ALPR em bash

Padrão comum: gerar um lote de placas conhecidas, salvar como ground truth, e comparar contra a saída do seu pipeline de OCR.

#!/usr/bin/env bash
# testa-ocr.sh - valida saida do pipeline de OCR contra placas geradas

curl -s "https://fakeforge.com.br/api/generate?type=placa&quantity=100" \
  | jq -r '.data[]' > placas-esperadas.txt

while read -r placa; do
  saida_ocr=$(./scripts/rodar_ocr.sh "$placa")  # seu binário/wrapper de OCR
  if [ "$saida_ocr" != "$placa" ]; then
    echo "FALHOU: esperado=$placa lido=$saida_ocr"
    exit 1
  fi
done < placas-esperadas.txt

echo "OCR passou em 100 placas Mercosul"

Comparação: qual escolher

CenárioAPI RESTAlgoritmo bash local
Só placa Mercosul✅✅
Placa antiga também✅⚠️ precisa outra função
Export CSV/SQL nativo✅❌
100% offline❌✅
CustoFree 50/diaR$0

Perguntas frequentes

Como gerar placa Mercosul via curl?+

GET https://fakeforge.com.br/api/generate?type=placa&quantity=100. Retorna JSON com placas no formato LLLNLNN, sem as letras I, O ou Q. Use type=placaAntiga pro formato legado.

Dá pra usar essas placas pra testar um pipeline de OCR?+

Sim. É um dos usos mais comuns: gerar um lote como ground truth, salvar num arquivo, e comparar contra a saída do seu OCR/ALPR pra validar a taxa de acerto.

Existe jeito de gerar placa sem chamar a API?+

Sim. O algoritmo local em bash monta a placa Mercosul sorteando letras válidas (sem I, O, Q) e dígitos, sem depender de rede.

A API valida se a placa tem letra proibida?+

As placas geradas pela API já vêm sem I, O ou Q, então não é necessário validar depois. Se você receber placas de outra fonte, use a regex [A-HJ-NP-Z] pra filtrar.

Próximos passos