brkit.dev

Plataforma comum (chave de API, limite por minuto, cota mensal, medição e cobrança pelo Asaas) com as primeiras APIs do portfólio, pronta para a Vercel.

O que já existe

Endpoint	O que faz
GET /v1/qr?data=...&format=png|svg&size=256&margin=2&ecc=M	QR Code estático
POST /v1/qr/codes { "url": "https://..." }	Cria QR Code dinâmico (link curto /r/:id, destino editável)
GET /v1/qr/codes?id=...	Destino e contagem de leituras
PATCH /v1/qr/codes?id=... { "url": "https://..." }	Troca o destino sem mudar a imagem
GET /r/:id	Redirecionamento público (302) e contagem de leituras
POST /v1/pix/qr { "key", "name", "city", "amount?", "txid?" }	BR Code do Pix ("copia e cola") estático + imagem PNG
POST /v1/pix/decode { "br_code": "000201..." }	Abre um BR Code: confere o CRC e devolve chave, beneficiário, valor e txid
POST /v1/boleto/decode { "code": "00190.50095 ..." }	Valida linha digitável (47/48) ou código de barras (44), converte entre as duas e extrai banco, valor e vencimento
POST /v1/payments/decode { "code": "..." }	Aceita Pix, linha digitável ou código de barras sem saber o formato antes; devolve envelope comum + decodificação nativa
POST /v1/nfe/decode { "key": "3526..." }	Lê a chave de acesso de NF-e, NFC-e, CT-e e MDF-e: confere o dígito e abre UF, emissão, CNPJ, modelo, série e número
POST /v1/nfe/key { "uf", "issued", "cnpj", "model", "series", "number" }	Monta a chave de acesso a partir dos campos e calcula o dígito verificador
GET ou POST /v1/validate/cnpj	Valida CNPJ numérico e alfanumérico (módulo 11, ASCII − 48)
POST /v1/validate/cpf { "value": "..." }	Valida CPF (só por POST: é dado pessoal e query string vai para logs)
GET /v1/holidays?year=2026	Feriados nacionais e pontos facultativos federais
GET /v1/holidays/business-days?from=2026-10-01&to=2026-10-31	Dias úteis (sem fins de semana e feriados nacionais)
POST /v1/billing/checkout	Contrata um plano (assinatura mensal no Asaas) e devolve o link da fatura
GET /v1/billing	Plano em vigor, vencimento, assinatura, uso do mês e link pendente
PUT /v1/billing { "plan": "scale" }	Troca o plano sem cancelar (upgrade vale na hora; downgrade, no próximo pagamento)
DELETE /v1/billing	Cancela a assinatura (o acesso pago segue até o fim do período já pago)
POST /api/webhooks/asaas	Webhook do Asaas (autenticado por token)
POST /v1/signup { "email": "..." }	Pede uma chave free: envia código de verificação (pública)
POST /v1/signup/verify { "email", "code" }	Confere o código e devolve a chave, uma única vez (pública)
POST /v1/keys/rotate	Troca o segredo da chave atual (autenticado); a anterior morre na hora
POST /v1/keys/recover { "email": "..." }	Perdeu a chave: envia código para substituí-la (pública)
POST /v1/keys/recover/verify { "email", "code" }	Confere o código e devolve a chave nova (pública)
GET /v1/health	Verificação de saúde (pública)
GET /v1/openapi.json	Especificação OpenAPI 3.1 desta instalação (pública)

Autenticação: header x-api-key: ak_live_... ou Authorization: Bearer ak_live_.... Toda resposta autenticada traz x-ratelimit-* e x-usage-*. Erros seguem o formato { "error": { "code", "message" } }.

Para que serve

Cada endpoint resolve um problema concreto. A especificação em /v1/openapi.json traz, em cada operação, um bloco "Quando usar" e exemplos de requisição e resposta prontos para copiar.

Situação	Endpoint
Campo único de "código de pagamento" no app, ou leitor de câmera que tanto lê QR de Pix quanto código de barras — sem ramificar no cliente antes de saber o formato	POST /v1/payments/decode
Conferir a chave que o fornecedor mandou antes de consultar a SEFAZ, ou descobrir de qual estado e mês é um documento sem abrir o XML	POST /v1/nfe/decode
Montar a chave de acesso na hora de emitir, para o XML e o DANFE	POST /v1/nfe/key
Cobrar no checkout, por WhatsApp ou numa fatura, com o número do pedido voltando no extrato do PSP	POST /v1/pix/qr
Conferir o código que o cliente colou antes de dar baixa, ou casar um Pix recebido com o pedido pelo txid	POST /v1/pix/decode
Dar baixa em boleto enviado por e-mail sem digitar valor e vencimento à mão	POST /v1/boleto/decode
Validar o código no formulário antes de mandar ao banco — código errado volta rejeitado e vira chamado de suporte	POST /v1/boleto/decode
Converter o que o leitor de código de barras capturou em linha digitável	POST /v1/boleto/decode
Barrar erro de digitação no cadastro antes de gravar, inclusive CNPJ alfanumérico	GET /v1/validate/cnpj, POST /v1/validate/cpf
Cardápio, cartaz ou etiqueta cujo destino muda depois de impresso, com contagem de leituras	POST /v1/qr/codes
Prazo de entrega, SLA ou vencimento contado em dias úteis, com os feriados que entraram na conta	GET /v1/holidays/business-days
Bloquear agendamento em feriado, sem manter tabela que envelhece (Carnaval e Corpus Christi movem todo ano)	GET /v1/holidays

Dois argumentos que costumam decidir a compra, e que a documentação explica em detalhe:

• O CNPJ alfanumérico está em vigor desde julho de 2026. Expressões regulares antigas que só aceitam dígitos passam a recusar empresa válida, e o cálculo do dígito mudou. Pela NT 2026.004 isso alcança também a chave de acesso da NF-e: as 12 posições de raiz e ordem do CNPJ aceitam letras, e o dígito da chave passou a valer cada caractere pelo ASCII menos 48.
• O fator de vencimento do boleto reiniciou em fevereiro de 2025, então todo fator mapeia duas datas possíveis. A resposta traz as duas leituras e sinaliza a ambiguidade, em vez de chutar.

This is the beginning of the README. Read the rest at the original. Read the full README ↗