Blog

Định dạng JSON và sao chép JSON Pointer của một giá trị

Định dạng phản hồi API một dòng ngay trong trình duyệt rồi sao chép JSON Pointer từ cây. Ví dụ cũng minh họa cách thu gọn và kiểm tra cú pháp.

Giao diện tiếng Anh hiển thị JSON một dòng bên cạnh kết quả đã thụt lề.

Khi API trả về JSON trên một dòng, thêm ngắt dòng giúp đọc các giá trị dễ hơn. Nếu cần báo rằng sản phẩm thứ hai đã hết hàng, hãy ghi thêm đường dẫn để người khác tìm được đúng giá trị. Thử cả hai thao tác với danh sách sản phẩm giả lập trong công cụ định dạng, thu gọn và kiểm tra JSON. Dữ liệu được dán vào sẽ được xử lý ngay trong trình duyệt.

Giúp phản hồi một dòng dễ đọc hơn

Dán mẫu sau vào “JSON đầu vào”.

{"items":[{"sku":"A-001","stock":12},{"sku":"B-002","stock":0}]}
  1. Đặt “Độ thụt dòng” thành 2 rồi bấm “Định dạng →”.
  2. Trong “Kết quả”, tìm phần tử thứ hai của mảng items. Sản phẩm có sku là B-002 có stock bằng 0.
  3. Để lưu kết quả đã định dạng thành tệp, bấm “Sao chép”, dán vào trình soạn thảo rồi lưu. Nếu cần thu gọn thành một dòng, bấm “Thu gọn →” trước khi sao chép.
Trong giao diện tiếng Anh, ô đầu vào chứa danh sách sản phẩm, ô đầu ra hiển thị JSON thụt lề hai dấu cách.
Hai ô riêng giúp đối chiếu dòng gốc với cấu trúc phân cấp sau khi định dạng.

Tìm đường dẫn đến số tồn kho của sản phẩm thứ hai trong cây

  1. Giữ nguyên đầu vào và bấm “Dạng cây”.
  2. Mở items rồi mở [1] và chọn "stock": 0. Chỉ số mảng bắt đầu từ 0 nên [1] là phần tử thứ hai.
  3. Kiểm tra JSON Pointer đã chọn là /items/1/stock rồi bấm “Sao chép đường dẫn”. Khi ghi lại đường dẫn, hãy ghi cả phản hồi đã kiểm tra.
Cây trong giao diện tiếng Anh mở phần tử thứ hai của items và hiển thị /items/1/stock cho giá trị stock được chọn.
Ô đường dẫn cho biết vị trí của giá trị được chọn. Giá trị đó là 0.

Trong JSON Pointer, dấu gạch chéo trong khóa được viết thành ~1, còn dấu ngã thành ~0. Ví dụ, khóa đơn stock/on-hand được viết thành stock~1on-hand. Xem cú pháp trong RFC 6901.

Kiểm tra cú pháp nếu không định dạng được

Nếu viết phần tử thứ hai thành {"sku":"B-002","stock":0,}, dấu phẩy thừa ngay trước dấu ngoặc nhọn đóng sẽ gây lỗi cú pháp. Bấm “Kiểm tra” để kiểm tra. Nếu trình duyệt cung cấp vị trí lỗi, công cụ sẽ hiển thị dòng và cột. Xóa dấu phẩy rồi bấm “Kiểm tra” lần nữa trước khi định dạng.

“Kiểm tra” kiểm tra cú pháp JSON. Xem đặc tả hoặc lược đồ API để biết stock có bắt buộc hay có thể nhận giá trị âm hay không.