Yêu cầu API đầu tiên của bạn trong Phím tắt
Để yêu cầu API đầu tiên, bạn tạo URL trỏ vào “điểm cuối” của API mà bạn muốn trao đổi và sau đó chuyển URL đó vào tác vụ Lấy nội dung của URL. Khi phím tắt được chạy, tác vụ này đưa ra yêu cầu API.
Xây dựng yêu cầu API
Điểm cuối dự báo của Dark Sky cần một yêu cầu URL để được định dạng như sau:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Văn bản trong dấu ngoặc sẽ được điền bằng khóa API và vị trí mà bạn muốn lấy dữ liệu dự báo.
Trong ứng dụng Phím tắt, đặt khóa API của bạn từ Dark Sky trong tác vụ Văn bản đầu tiên, được chuyển vào URL dưới dạng biến. Các giá trị
LATvàLONGđã được đặt thành37.8267và-122.4233, là các tọa độ cho Đảo Alcatraz ở San Francisco. (Bạn có thể thay đổi những giá trị đó thành một vị trí khác).Hãy thử sử dụng tác vụ Lấy vị trí hiện tại và đặt thành một Biến ma thuật được thiết lập thành Vĩ độ và Kinh độ trong tác vụ URL để lấy dữ liệu thời tiết địa phương bất kỳ lúc nào bạn chạy phím tắt.
Thực hiện yêu cầu API bằng tác vụ Lấy nội dung của URL
Trong trình sửa phím tắt của ứng dụng Phím tắt, đặt Lấy nội dung của URL thành Nâng cao.
Các tùy chọn dành cho các loại yêu cầu API mà bạn có thể đưa ra sau đây trở nên khả dụng:
GETcho phép bạn truy xuất dữ liệu từ API để đọc.POSTcho phép bạn tạo dữ liệu mới.PUTvàPATCHcho phép bạn cập nhật dữ liệu bằng cách thay thế hoặc sửa đổi tương ứng.DELETEcho phép bạn xóa một đối tượng được chỉ định trong yêu cầu URL.
Đối với ví dụ này, sử dụng yêu cầu
GETđể truy xuất dữ liệu từ API của Dark Sky.Bây giờ, tác vụ URL có yêu cầu của bạn và tác vụ Lấy nội dung của URL được thiết lập thành
GETdữ liệu, bạn đã sẵn sàng đưa ra yêu cầu API.Ghi chú: Khi tác vụ Lấy nội dung của URL được chuyển thành
POST,PUThoặcPATCH, một tham số mới có tên là Yêu cầu nội dung được thêm. Yêu cầu nội dung cho phép bạn gửi JSON, một biểu mẫu hoặc một tệp cho API như một phần của yêu cầu. Việc này cho phép bạn nhập dữ liệu mới theo cách thủ công hoặc bằng cách sử dụng biến để có thể gửi dữ liệu cho API để tạo, thay thế hoặc sửa đổi mục nhập.Chạm vào
để kiểm tra phím tắt (tác vụ Xem nhanh trong phím tắt cho phép bạn xem trước dữ liệu mà API trả về).
Chúc mừng, bạn vừa đưa ra yêu cầu API đầu tiên bằng Phím tắt.
Khi mới xem qua, API dường như trả về nhiều văn bản được định dạng lạ. Khi kiểm tra kỹ hơn, bạn có thể thấy rằng văn bản chứa thông tin dự báo thời tiết. Dữ liệu thời tiết này được mã hóa bằng JSON, viết tắt của Ký pháp đối tượng JavaScript.
Để tìm hiểu về cách làm việc với JSON và tiếp tục với ví dụ về API của Dark Sky, hãy xem Giới thiệu về sử dụng JSON trong Phím tắt.