Revisão de API em Node.jsTreinamento em programação

Revisão de código de API em Node.js e Express

Entrega a partir de 1 diaAjustes incluídosControle de qualidade
Pagamento protegidoDetalhes
  • Os ajustes previstos no pacote são gratuitos.
  • Se você não responder em 3 dias após a entrega, o trabalho é aprovado automaticamente.
Fazer pedido · US$ 35

O dinheiro fica reservado no pagamento e só é liberado quando você aprova o trabalho.

Revisão de código de API em Node.js e Express

Exemplo de resultado

Exemplo do pacote Padrão

Revisão de código: script em Python para importar pedidos de uma loja virtual

O que o código faz

  1. Lê o orders.csv exportado da loja.
  2. Para cada item do pedido, procura o produto pelo SKU no stock.xlsx e subtrai a quantidade.
  3. Grava o estoque atualizado e registra os totais em import_log.txt.

A estrutura é clara e as funções têm bons nomes. A maioria dos problemas vem de dados de entrada que não chegam no formato que o script espera.

Bugs e pontos fracos

#LinhaGravidadeProblema
148AltaO mesmo CSV pode ser importado duas vezes; não há checagem dos IDs de pedido já processados. É a causa mais provável do estoque negativo.
272Altaint(row["qty"]) quebra com valores vazios ou "2.0" de pedidos reembolsados.
395MédiaA busca por SKU diferencia maiúsculas: "gt-101" e "GT-101" viram produtos diferentes.
4130MédiaO arquivo é aberto sem encoding="utf-8", então nomes com acento quebram no Windows.
5201BaixaUm except: genérico esconde os erros reais e deixa o log inútil.

Trechos corrigidos

Problema 1: pular pedidos já importados

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... lógica existente ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Por quê: cada pedido é aplicado uma única vez, mesmo que você rode o script de novo com o mesmo arquivo.

Problema 2: ler a quantidade com segurança

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Pedido %s: quantidade inválida %r, ignorado", row["order_id"], raw)
    continue

Por quê: itens reembolsados ou parciais são pulados com um aviso claro, em vez de interromper toda a importação.

Problema 3: padronizar os SKUs

sku = row["sku"].strip().upper()

Aplique o mesmo .strip().upper() ao montar o dicionário de estoque.

Estilo e legibilidade

  • process() tem 90 linhas; divida em read_orders, apply_to_stock e write_report.
  • Troque os números de coluna "mágicos" (row[7]) pelos nomes dos cabeçalhos.

Teste cada correção em uma cópia dos seus arquivos: lemos o código, mas não o executamos.

Cliente: dona de uma loja de chás que escreveu um script em Python de 310 linhas para importar os pedidos de um CSV exportado para a planilha de estoque Problema relatado: "Às vezes o estoque fica negativo, e o script trava com alguns arquivos."

O cliente e todos os dados são fictícios.

Sobre este serviço

APIs em Express costumam quebrar nos mesmos pontos: uma rota async que lança um erro e deixa a requisição pendurada, middleware na ordem errada, corpos de requisição usados sem validação e chamadas síncronas de arquivo que bloqueiam todos os outros usuários. Lemos as suas rotas, middleware e chamadas ao banco de dados, explicamos como uma requisição passa por eles e marcamos travamentos, falhas de segurança e pontos lentos. Os fragmentos corrigidos usam async e await com tratamento de erros centralizado e status codes claros.

O que está incluído

  • O que você recebeUma revisão escrita na página do pedido: o caminho de uma requisição pela sua API, problemas por importância e código de rotas e middleware corrigido. O Premium inclui uma sugestão de estrutura de pastas para rotas, serviços e acesso a dados.
  • Fluxo da requisiçãoOrdem do middleware e roteamento
  • Tratamento de errosSem requisições penduradas nem travamentos
  • Validação de entradaBodies, params e query strings
  • Event loopChamadas bloqueantes encontradas e substituídas
  • Segredos e configuraçãoChaves fora do código, uso de env

Como funciona

  1. 1
    BriefingVocê cola rotas, middleware e logs
  2. 2
    LeituraSeguimos uma requisição de ponta a ponta
  3. 3
    RevisãoVocê recebe os problemas e o código corrigido

O que precisamos de você

As suas rotas, o middleware e o arquivo principal do app colados como texto ou em capturas de tela, as versões do Node.js e do Express, o banco de dados que você usa e os erros do log do servidor.

Vamos perguntar:

  • Quais versões do Node.js e do Express?
  • Qual banco de dados e qual biblioteca você usa?
  • O que dá errado e o que diz o log do servidor?
  • A API é pública ou usada só pelo seu próprio front-end?

Compare os pacotes

BásicoCódigo de API de até 100 linhasUS$ 15PadrãoCódigo de API de até 400 linhasUS$ 35PremiumAté 1.000 linhas com plano de estruturaUS$ 69
Prazo1 dia2 dias3 dias
Ajustes123
Linhas de códigoaté 100até 400até 1.000
Fragmentos corrigidosSimSimSim
Plano de estrutura de pastasNãoNãoSim
Fazer pedidoFazer pedidoFazer pedido

Pagamento protegido

Você paga ao fazer o pedido, mas o dinheiro só é liberado pelo trabalho aprovado.

  • Preço fixoO preço do pacote não muda depois que você paga.
  • O dinheiro fica reservadoAo pagar, o valor fica apenas reservado. Ele só é repassado quando você aprova o trabalho.
  • Verificado antes da entregaCada resultado passa por um controle de qualidade antes de chegar até você, e você o vê na página do pedido antes de aprovar.
  • Ajustes gratuitosPeça ajustes dentro do seu briefing quantas vezes o pacote permitir.
  • Aprovação após 3 diasSe em 3 dias após a entrega você não aprovar o trabalho nem pedir ajustes, ele é aprovado automaticamente. Se você escrever no chat do pedido após a entrega, o pedido fica em espera; depois que respondermos, podemos reiniciar a contagem de 3 dias e avisaremos no chat.
  • Refazer ou reembolso totalSe o resultado não corresponder ao seu briefing e os ajustes não resolverem, ou se o trabalho levar mais que o dobro do prazo, escreva no chat do pedido: refazemos o trabalho ou reembolsamos o pagamento integralmente.
Como funciona →

Perguntas e respostas

Vocês executam o meu código?

Não. Lemos o código com atenção e analisamos como ele se comporta, mas não o executamos, então teste cada correção sugerida no seu próprio projeto.

Devo remover as minhas chaves de API antes de enviar?

Sim. Substitua chaves, senhas e connection strings por marcadores. Não precisamos delas para revisar o código.

Vocês fazem teste de carga na minha API?

Não, não chamamos o seu servidor. Apontamos o código que vai ficar lento sob carga para você mesmo testar.

Fazer pedido · US$ 35· 2 dias