<aside> ©️ IT: Từ A tới Á cho người ngoài ngành by @Rose Trinh

</aside>

Trong bài trước API là gì?, mình đã cùng tìm hiểu về API, và trong một trong những bước, mình có nhắc đến rằng "API search trả về kết quả dưới dạng JSON". Vậy JSON là gì?

API có thể truyền nhiều loại thông tin khác nhau giữa máy chủ và máy khách. Một số dạng phổ biến bao gồm:

Dữ liệu dạng văn bản

API thường truyền tải dữ liệu dạng văn bản như JSON hoặc XML.

• JSON (JavaScript Object Notation): Đây là định dạng dữ liệu nhẹ, dễ đọc, và thường được sử dụng trong web và API vì nó rất đơn giản. Dữ liệu trong JSON được tổ chức theo cặp "key": "value", giống như cách tổ chức đối tượng trong JavaScript.

  Ví dụ JSON:

  {
    "name": "John",
    "age": 30
  }
  

• XML (eXtensible Markup Language): Dữ liệu trong XML được cấu trúc bằng các thẻ mở và thẻ đóng, tương tự như HTML. XML có thể phức tạp hơn JSON, nhưng linh hoạt và phù hợp cho các hệ thống yêu cầu cấu trúc dữ liệu phức tạp.

  Ví dụ XML:

  <person>
    <name>John</name>
    <age>30</age>
  </person>
  

2. Tệp tin (Files)

Ngoài việc truyền dữ liệu văn bản, API cũng có thể gửi và nhận các tệp. Đây là những tệp mà người dùng hoặc ứng dụng tải lên hoặc tải xuống từ máy chủ. Một số dạng tệp phổ biến được truyền qua API bao gồm:

• Hình ảnh: (.jpg, .png)
• Video: (.mp4)
• Tài liệu: (.pdf, .docx)
• Âm thanh: (.mp3)
• Tệp nén: (.zip)

Khi gửi tệp qua API, dữ liệu thường được truyền dưới dạng multipart/form-data. Định dạng này cho phép gửi đồng thời cả dữ liệu văn bản và các tệp tin, giúp máy chủ dễ dàng nhận diện và xử lý từng phần trong yêu cầu.

Như ở đây, mọi người có thể thấy là Notion API /search dùng JSON để truyền tải kết quả tìm kiếm.