alicerce, s.m. — base sobre a qual tudo mais se apoia
Infra básica de API pra quem constrói no Brasil.
Cinco blocos pequenos que qualquer produto brasileiro acaba precisando, numa API só, com o mesmo formato de resposta e as mesmas regras de autenticação e limite.
alicerce (pt-br) — the foundation everything else stands on
Basic API infrastructure for building in Brazil.
Five small blocks almost every Brazilian product ends up needing, behind one API, with one response format and the same auth and rate-limit rules across all of them.
APIs
APIs
-
IP SYNC documentação → docs →Geolocalização de IPIP geolocationPaís, cidade, coordenadas e provedor a partir de um endereço IP.Country, city, coordinates and provider from an IP address.
-
CEP SYNC documentação → docs →Endereço a partir do CEPAddress from postal codeLogradouro, bairro, cidade e UF direto da base dos Correios.Street, neighborhood, city and state from the official postal database.
-
DNS SYNC documentação → docs →Consulta DNSDNS lookupRegistros A, AAAA, NS, MX, TXT e CNAME, mais checagem de blocklist.A, AAAA, NS, MX, TXT and CNAME records, plus a blocklist check.
-
EMAIL SYNC documentação → docs →Verificação de emailEmail verificationSintaxe, MX e, opcionalmente, uma checagem SMTP.Syntax, MX records and an optional SMTP probe.
-
CRON ASYNC documentação → docs →Jobs agendadosScheduled jobsTarefas recorrentes rodando isoladas em containers Docker.Recurring tasks running isolated in Docker containers.
SYNC responde na hora, na própria chamada. ASYNC aceita o pedido e roda depois — a resposta é uma confirmação, não o resultado. Cada API documenta isso na sua própria página.
SYNC answers inline, in the same call. ASYNC accepts the request and runs it later — the response is an acknowledgement, not the result. Each API documents this on its own page.
Como usar
How to use it
# registrar → logar → usar o token# register → log in → use the token
curl -X POST https://api.alicercelabs.com.br/api/v1/user/register \
-d '{"username":"voce","email":"voce@exemplo.com","password":"..."}'
curl -u voce:senha https://api.alicercelabs.com.br/api/v1/user/login
curl https://api.alicercelabs.com.br/api/v1/cep/01310100 \
-H "Authorization: Bearer <token>"
Limites por IP, contados por API: 10.000/dia, no máximo 416/hora pra um pico não gastar o dia inteiro de uma vez. Detalhes por endpoint em cada página de API.
Limits are per IP, counted per API: 10,000/day, capped at 416/hour so a burst can't spend the whole day's budget at once. Per-endpoint detail on each API's page.