Nieprawidłowy JSON: jak znaleźć niewłaściwy przecinek i uporządkować dane

Integracja nie powiedzie się i serwer odpowiada, że ​​JSON jest nieprawidłowy. Otwierasz zawartość i widzisz nawiasy klamrowe, nawiasy i dziesiątki wierszy bez wcięć. Zanim zaczniemy szukać skomplikowanego zagadnienia API, warto sprawdzić podstawy: czy dokument ma prawidłowy format JSON?

Formatowanie ułatwia zobaczenie struktury

Um Formater JSONzmienia rozmieszczenie spacji i wcięć, aby pokazać, gdzie zaczyna się i kończy każdy obiekt. Może także wskazywać błędy składniowe. Typowe błędy obejmują dodatkowe przecinki po ostatnim elemencie, pojedyncze cudzysłowy zamiast podwójnych cudzysłowów oraz nazwy właściwości bez cudzysłowów.

JSON akceptuje ciągi, liczby, wartości logiczne, wartości null, listy i obiekty. SłowoPRAWDAróżni się od ciągu znaków"PRAWDA"; interfejs API oczekujący wartości logicznej może odrzucić drugą. Formatowanie poprawia czytelność, ale nie potwierdza zgodności nazw i typów z umową serwisową.

Komunikaty o błędach służą jako wskazówki

Gdy walidator wskaże linię, sprawdź także poprzednią. Otwarty ogranicznik powyżej może spowodować błąd tylko wtedy, gdy parser napotka następny element. W automatycznie generowanych danych porównaj pierwszą i ostatnią część pliku, aby dowiedzieć się, czy nastąpiło obcięcie.

Nigdy nie dziel się tajemnicami bezmyślnie

Przed skopiowaniem JSON do środowisk zewnętrznych usuń tokeny, hasła i dane osobowe. Jeśli treść jest poufna, wybierz narzędzia przetwarzające lokalnie i sprawdź, jak działają. Po poprawieniu składni przetestuj z prawdziwym systemem: prawidłowy JSON może nadal zawierać błędne informacje.

Piękny JSON nadal może się mylić

Obiekt może być poprawny składniowo i mimo to wysyłać datę w formacie nieakceptowanym przez usługę. Na przykład interfejs API oczekuje listy produktów, ale otrzymuje pojedynczy obiekt; formatyzator nie ma możliwości poznania kontraktu na tę integrację. Po naprawieniu wcięcia sprawdź w dokumentacji systemu dokładne nazwy właściwości i wymagane pola.

Jeśli debugujesz błąd, zmniejsz przykład bez usuwania problematycznego zachowania. Mniejszy JSON ułatwia zauważenie nieprawidłowego typu lub powtarzającej się właściwości. Nie zapominaj, że znaki kontrolne, cudzysłowy i ukośniki odwrotne w ciągach znaków muszą przestrzegać zasad formatu. W logach udostępnianych stronom trzecim przed wysłaniem zamień dane uwierzytelniające i dane osobowe na fikcyjne wartości.