Khám phá HTTP-based APIs với cURL (tiếp tục)
Tiếp theo, chúng ta tiếp tục khám phá các phương thức HTTP giới thiệu học phần trước. Cụ thể là, chúng ta sẽ bắt
đầu với một phương thức bạn có thể sử dụng để điều chỉnh các tài nguyên trên API: POST.
Sử dụng phương thức HTTP POST để tạo một tài nguyên mới. Trong code trước. bạn giành networks thuộc về một
organization cụ thể. Bây giờ, cho cùng organization, bạn muốn tạo một network mới (code dưới)
(1) Phương thức HTTP để tạo các objects mới là POST, và nó được chỉ ra với cờ -X. Phương thức POST yêu cầu dữ
liệu.
(2) Với cờ -d, hay –data, chúng ta truyền một JSON object với các thuộc tính của network mới trong dạng một cặp
key-value (name và productTypes).
(3) Header Content-Type được sử dụng để chỉ ra hình thức dữ liệu. Trong trường hợp này, chúng ta đang sử dụng JSON,
nhưng các hình thức khác cũng được hố trợ (e.g, XML).
Học làm cách nào xây dựng một yêu cầu API đúng đắn yêu cầu quen thuộc với tài liệu hướng dẫn API. Tài liệu hướng
dẫn API (định nghĩa và tiêu chuẩn kĩ thuật API) định nghĩa một URL đã cho phải là gì, dạng yêu cầu HTTP, các
headers và body cần gì để cho một lời gọi API thành công. Ví dụ, trong ví dụ trên, chúng ta truyền các thuộc tính
được yêu cầu cho yêu cầu POST, nhưng chúng ta cũng có thể đã truyền các thuộc tính tùy chọn, như timeZone hay
tags. Tất cả các thuộc tính này được định nghĩa trong tài liệu hướng dẫn API. Ngoài ra, thực hiện yêu cầu GET
cung cấp một vài gợi ý về các thuộc tính được yêu cầu, như bạn có thể thấy trong đầu ra của networks GET (code trước)
và dữ liệu sử dụng cho POST.