Przegląd API w Node.jsSzkolenia z programowania

Przegląd kodu API w Node.js i Express

Realizacja od 1 dniaPoprawki w cenieKontrola jakości
Ochrona płatnościSzczegóły
  • Poprawki w ramach pakietu są bezpłatne.
  • Jeśli nie odpowiesz w ciągu 3 dni od dostarczenia pracy, zostanie ona zaakceptowana automatycznie.
Zamów · 32 €

Pieniądze są rezerwowane w chwili płatności i przekazywane dopiero po akceptacji pracy.

Przegląd kodu API w Node.js i Express

Przykładowy rezultat

Przykład dla pakietu Standard

Przegląd kodu: skrypt Python do importu zamówień dla małego sklepu internetowego

Co robi kod

  1. Wczytuje orders.csv z eksportu sklepu.
  2. Dla każdej pozycji zamówienia znajduje produkt po SKU w stock.xlsx i odejmuje ilość.
  3. Zapisuje zaktualizowane stany i loguje sumy do import_log.txt.

Struktura jest czytelna, a funkcje dobrze nazwane. Większość problemów dotyczy danych wejściowych, które wyglądają inaczej, niż zakłada skrypt.

Błędy i słabe punkty

#LiniaWagaProblem
148WysokaTen sam CSV można zaimportować dwa razy; brak sprawdzania już przetworzonych ID zamówień. To najbardziej prawdopodobna przyczyna ujemnych stanów.
272Wysokaint(row["qty"]) wywala się na pustych wartościach lub "2.0" przy zamówieniach ze zwrotem.
395ŚredniaWyszukiwanie SKU rozróżnia wielkość liter: "gt-101" i "GT-101" to dla skryptu różne produkty.
4130ŚredniaPlik otwierany jest bez encoding="utf-8", więc w Windowsie psują się nazwy z polskimi znakami.
5201NiskaGołe except: ukrywa prawdziwe błędy i sprawia, że log jest bezużyteczny.

Poprawione fragmenty

Problem 1: pomijanie już zaimportowanych zamówień

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... dotychczasowa logika ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Dlaczego: każde zamówienie jest uwzględniane raz, nawet jeśli uruchomisz skrypt ponownie na tym samym pliku.

Problem 2: bezpieczne odczytanie ilości

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Zamówienie %s: błędna ilość %r, pominięto", row["order_id"], raw)
    continue

Dlaczego: pozycje zwrócone lub częściowe są pomijane z czytelną adnotacją, zamiast zatrzymywać cały import.

Problem 3: normalizacja SKU

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

To samo .strip().upper() zastosuj przy budowaniu słownika stanów.

Styl i czytelność

  • process() ma 90 linii; podziel ją na read_orders, apply_to_stock, write_report.
  • Zastąp "magiczne" numery kolumn (row[7]) nazwami nagłówków.

Przetestuj każdą poprawkę na kopii plików: przeczytaliśmy kod, ale go nie uruchamialiśmy.

Klient: właściciel sklepu z herbatą, który napisał 310-liniowy skrypt Python importujący zamówienia z eksportu CSV do arkusza stanów magazynowych Zgłoszony problem: "Czasem stany schodzą poniżej zera, a przy niektórych plikach skrypt się wysypuje."

Klient i wszystkie dane są wymyślone.

O usłudze

API w Express psują się zwykle w tych samych miejscach: asynchroniczna trasa rzuca wyjątek i zostawia żądanie zawieszone, middleware w złej kolejności, treść żądań używana bez walidacji i synchroniczne operacje na plikach, które blokują wszystkich pozostałych użytkowników. Czytamy twoje trasy, middleware i wywołania bazy danych, wyjaśniamy, jak przechodzi przez nie żądanie, i zaznaczamy awarie, luki bezpieczeństwa i wolne miejsca. Poprawione fragmenty używają async i await z centralną obsługą błędów i jasnymi kodami statusu.

Co obejmuje usługa

  • Co otrzymujeszPisemne omówienie na stronie zamówienia: droga żądania przez twoje API, problemy według wagi i poprawiony kod tras oraz middleware. W pakiecie Premium także proponowana struktura folderów dla tras, usług i dostępu do danych.
  • Przepływ żądaniaKolejność middleware i routing
  • Obsługa błędówBez zawieszonych żądań i awarii
  • Walidacja danych wejściowychTreść żądania, parametry i query string
  • Pętla zdarzeńBlokujące wywołania znalezione i zastąpione
  • Sekrety i konfiguracjaKlucze poza kodem, użycie env

Jak to działa

  1. 1
    BriefWklejasz trasy, middleware i logi
  2. 2
    LekturaŚledzimy żądanie od początku do końca
  3. 3
    PrzeglądOtrzymujesz listę problemów i poprawiony kod

Czego potrzebujemy od Ciebie

Twoje trasy, middleware i główny plik aplikacji wklejone jako tekst lub zrzuty ekranu, wersje Node.js i Express, używana baza danych oraz błędy z logu serwera.

Zapytamy Cię:

  • Które wersje Node.js i Express?
  • Jakiej bazy danych i biblioteki używasz?
  • Co idzie nie tak i co mówi log serwera?
  • Czy API jest publiczne, czy używa go tylko twój własny front-end?

Porównaj pakiety

PodstawowyKod API do 100 linii14 €StandardKod API do 400 linii32 €PremiumDo 1000 linii z planem struktury62 €
Termin1 dzień2 dni3 dni
Poprawki123
Linie kodudo 100do 400do 1000
Poprawione fragmentyTakTakTak
Plan struktury folderówNieNieTak
ZamówZamówZamów

Ochrona płatności

Płacisz przy składaniu zamówienia, ale pieniądze są przekazywane tylko za zaakceptowaną pracę.

  • Stała cenaCena pakietu nie zmienia się po zapłacie.
  • Pieniądze są zarezerwowanePrzy płatności kwota jest tylko rezerwowana. Serwis otrzymuje ją dopiero po akceptacji pracy.
  • Sprawdzone przed dostarczeniemKażdy wynik przechodzi kontrolę jakości, zanim do Ciebie trafi, a przed akceptacją widzisz go na stronie zamówienia.
  • Bezpłatne poprawkiProś o poprawki w ramach briefu tyle razy, ile przewiduje pakiet.
  • Akceptacja po 3 dniachJeśli w ciągu 3 dni od dostarczenia pracy ani jej nie zaakceptujesz, ani nie poprosisz o poprawki, zostanie zaakceptowana automatycznie. Jeśli po dostarczeniu napiszesz na czacie zamówienia, zamówienie czeka; po naszej odpowiedzi możemy ponownie uruchomić odliczanie 3 dni i poinformujemy o tym na czacie.
  • Ponowne wykonanie lub pełny zwrot pieniędzyJeśli wynik nie odpowiada Twojemu briefowi, a poprawki tego nie naprawiły, lub praca trwa ponad dwa razy dłużej niż termin, napisz na czacie zamówienia: wykonamy pracę ponownie albo zwrócimy całą płatność.
Jak to działa →

Pytania i odpowiedzi

Czy uruchamiacie mój kod?

Nie. Uważnie go czytamy i analizujemy, jak się zachowuje, ale go nie uruchamiamy, więc przetestuj każdą proponowaną poprawkę we własnym projekcie.

Czy przed wysłaniem usunąć klucze API?

Tak. Zastąp klucze, hasła i connection stringi symbolami zastępczymi. Nie są nam potrzebne do przeglądu kodu.

Czy możecie zrobić test obciążeniowy mojego API?

Nie, nie wywołujemy twojego serwera. Wskazujemy kod, który zwolni pod obciążeniem, żebyś mógł go przetestować samodzielnie.

Zamów · 32 €· 2 dni