Mẹo nhỏ: Để tìm kiếm chính xác các bài viết của Vuihecungchocopie.vn, hãy search trên Google với cú pháp: "Từ khóa" + "vuihecungchocopie". (Ví dụ: công thức giải rubik 3x3 vuihecungchocopie). Tìm kiếm ngay
14 lượt xem

RESTful API là gì? Cách thiết kế RESTful API

Bạn đang xem: RESTful API là gì? Cách thiết kế RESTful API Tại Vuihecungchocopie                        

Bạn đang quan tâm đến RESTful API là gì? Cách thiết kế RESTful API phải không? Nào hãy cùng Vuihecungchocopie đón xem bài viết này ngay sau đây nhé, vì nó vô cùng thú vị và hay đấy!

Chúng ta có thể nói rằng các nguyên tắc rest và cấu trúc dữ liệu restful rất nổi tiếng trong lập trình web, đặc biệt là lập trình ứng dụng.

Có thể nói rằng bản thân phần còn lại không phải là một công nghệ. Đó là một cách để tạo các API với các nguyên tắc tổ chức nhất định. Các nguyên tắc này nhằm hướng dẫn các nhà phát triển tạo một môi trường xử lý yêu cầu API toàn diện.

Bạn đang xem: Restful api la gi

Để hiểu rõ hơn về api yên tĩnh , chúng tôi sẽ giải thích khái niệm api , nghỉ ngơi hoặc yên tĩnh tương ứng .

Api yên tĩnh là gì?

api còn lại là một tiêu chuẩn để thiết kế api cho các ứng dụng web (thiết kế dịch vụ web) để tạo điều kiện quản lý tài nguyên. Nó tập trung vào tài nguyên hệ thống (tệp văn bản, hình ảnh, âm thanh, video hoặc dữ liệu động …), bao gồm trạng thái tài nguyên được định dạng và truyền qua http.

restful api

Xem thêm: Cơ hội tuyển dụng lập trình viên API hàng đầu của Topdev

Giải thích phần tử

api ( a ứng dụng p lập trình i giao diện) là một tập hợp các quy tắc và cơ chế thông qua đó Quy tắc và các cơ chế mà ứng dụng hoặc thành phần tương tác với ứng dụng hoặc thành phần khác. Api có thể trả về dữ liệu mà ứng dụng của bạn cần ở các kiểu dữ liệu phổ biến như json hoặc xml.

rest ( re presentational s tate t transfer) là một phép chuyển đổi cấu trúc dữ liệu, một lược đồ kiểu viết api. Nó sử dụng các phương thức http đơn giản để tạo điều kiện giao tiếp giữa máy và máy. Do đó, thay vì sử dụng url để xử lý một số thông tin người dùng, phần còn lại sẽ gửi yêu cầu http tới url, chẳng hạn như get, post, delete, v.v., để xử lý dữ liệu.

api an toàn là một tiêu chuẩn cho các API được thiết kế để quản lý tài nguyên trong các ứng dụng web. restful là một trong những thiết kế api được sử dụng nhiều nhất hiện nay để cho phép các ứng dụng khác nhau (web, di động …) giao tiếp với nhau.

phần còn lại Chức năng quan trọng nhất là chỉ định cách sử dụng các phương thức http (chẳng hạn như lấy, đăng, đặt, xóa …) và cách định dạng url cho các ứng dụng web để quản lý tài nguyên. Restful không chỉ định logic mã ứng dụng và không bị giới hạn bởi ngôn ngữ lập trình ứng dụng. Bất kỳ ngôn ngữ hoặc khuôn khổ nào cũng có thể được sử dụng để thiết kế restful api .

nghỉ ngơi hoạt động như thế nào?

restful rest diagram api

phần còn lại chủ yếu hoạt động trên giao thức http. Các thao tác cơ bản trên sẽ sử dụng các phương thức http riêng.

  • get (select): Trả về một tài nguyên hoặc danh sách các tài nguyên.
  • Xuất bản (tạo): Tạo một tài nguyên mới.
  • put (cập nhật): Cập nhật thông tin tài nguyên.
  • xóa: Xóa tài nguyên.
  • Các phương pháp hoặc thao tác này thường được gọi là crud và tương ứng với tạo, đọc, cập nhật, xóa – tạo, đọc, chỉnh sửa, xóa.

    Hiện tại, hầu hết các lập trình viên viết restful api đều chọn json làm định dạng chính thức, nhưng nhiều người chọn xml làm định dạng. Nói chung, việc sử dụng bất cứ thứ gì bạn muốn rất tiện lợi và nhanh chóng. . .

    Xác thực và trả về dữ liệu

    api an toàn không sử dụng phiên và cookie, nó sử dụng access_token cho mỗi yêu cầu. Dữ liệu trả về thường có cấu trúc như sau:

    Mã trạng thái

    Xem thêm: Peptan là gì? Hiệu quả trong hỗ trợ điều trị bệnh xương khớp

    Khi chúng tôi yêu cầu một api, thường có một số mã trạng thái cần được xác định:

    • 200 ok – Phương thức get, put, patch hoặc delete trả về thành công.
    • 201 được tạo – Được trả lại khi tài nguyên được tạo thành công.
    • 204 không có nội dung – Được trả lại khi tài nguyên đã được xóa thành công.
    • 304 Không được Sửa đổi – Khách hàng có thể sử dụng dữ liệu được lưu trong bộ nhớ cache.
    • 400 Yêu cầu Không hợp lệ – Yêu cầu Không hợp lệ
    • 401 Không được phép – Yêu cầu yêu cầu xác thực.
    • 403 Forbidden – Quyền bị từ chối.
    • 404 Không tìm thấy – Không tìm thấy tài nguyên từ uri
    • Phương pháp 405 Không được phép – Người dùng hiện tại không cho phép phương pháp này.
    • 410 Gone – Tài nguyên không còn tồn tại và phiên bản cũ không còn được hỗ trợ.
    • 415 Loại phương tiện không được hỗ trợ – Loại tài nguyên này không được hỗ trợ.
    • 422 Đối tượng không thể xử lý – Dữ liệu chưa được xác thực
    • 429 Quá nhiều yêu cầu – Yêu cầu bị từ chối do giới hạn
    • Phiên bản nên được sử dụng

      Luôn sử dụng phiên bản để khi bạn cần nâng cấp api của mình mà vẫn hỗ trợ api cũ.

      Xây dựng api với laravel

      Lấy api được xây dựng trên laravel làm ví dụ, sau đó nhập tổng quan về các yêu cầu http.

      Yêu cầu http

      Có 9 phương pháp cho các yêu cầu http, hai phương pháp thường được sử dụng nhất là get và post

      • get: Được sử dụng để lấy thông tin từ máy chủ dựa trên uri đã cung cấp.
      • head: Tương tự như get, nhưng phản hồi trả về không có nội dung, chỉ có tiêu đề.
      • post: Gửi thông tin đến máy chủ dưới dạng http.
      • put: Ghi đè tất cả thông tin của đối tượng với nội dung đã gửi.
      • patch: Ghi đè thông tin thay đổi của đối tượng.
      • xóa: Xóa tài nguyên trên máy chủ.
      • kết nối: Thiết lập kết nối với máy chủ qua uri.
      • tùy chọn: Mô tả các tùy chọn giao tiếp cho tài nguyên.
      • dấu vết: Thực hiện các kiểm tra lặp lại dọc theo đường dẫn của tài nguyên.
      • Tuyến đường yên tĩnh

        Viết api sẽ khai báo bộ định tuyến trong tệp tuyến đường / api.php thay vì sử dụng tệp tuyến đường / web.php. Cài đặt mặc định cho tệp api.php trong laravel:

        • url: Các đường được khai báo trong tệp này được mặc định thành url tiền tố api (ví dụ: topdev.vn/api/products)
        • Phần mềm trung gian: Nhóm phần mềm trung gian được gán là api theo mặc định. Trong ứng dụng tệp / http / kernel, bạn sẽ thấy 2 phần mềm trung gian thuộc nhóm phần mềm trung gian: api là điều tiết (hạn chế yêu cầu / thời gian) và ràng buộc (ràng buộc mô hình) .
        • Giá trị mặc định này có thể được tùy chỉnh trong phương thức mapapiroutes của tệp ứng dụng / nhà cung cấp / routeerviceprovider.php

          Tạo các tuyến đường để thực hiện các thao tác như crud (tạo, đọc, cập nhật, xóa):

          Tuyến đã được gán ràng buộc phần mềm trung gian theo mặc định. Nếu bạn muốn sử dụng liên kết mô hình trong bộ điều khiển, chúng tôi sửa đổi các thông số trong tuyến như sau:

          Phương thức khai báo đơn giản hơn của chúng tôi cũng được hỗ trợ trong laravel:

          Bộ điều khiển tài nguyên

          Tương ứng với lộ trình thư giãn được khai báo ở trên, đặc biệt nếu phương thức apiresource được sử dụng, laravel cũng hỗ trợ phương thức xử lý tương ứng trong bộ điều khiển.

          Để tạo bộ điều khiển tài nguyên, chúng tôi chạy lệnh sau

          thợ làm php: controller api / productcontroller-api

          Ngoài ra, nếu bạn muốn sử dụng liên kết mô hình khi tạo bộ điều khiển tài nguyên, hãy sử dụng lệnh sau

          thợ làm thủ công php: controller api / productcontroller -api -model = models / product

          Tệp được tạo bởi productcontroller như sau, chúng tôi nhận thấy rằng các thông số của phương thức hiển thị, cập nhật, hủy sẽ thay đổi một chút.

          demo 1 Mã đơn giản trong bộ điều khiển kết hợp nguồn liên kết mô hình và nguồn định tuyến khi tạo api:

          Xem thêm: SDS LÀ GÌ? MSDS VÀ SDS CÓ GÌ KHÁC NHAU?

          Khi định tuyến apiresource được sử dụng theo mặc định, dữ liệu trả về sẽ tự động được chuyển đổi thành kiểu json và có trạng thái tương ứng, vì vậy bạn có thể trả về trực tiếp.

          Ngoài ra, nếu bạn muốn tùy chỉnh trạng thái trả về, bạn có thể tham khảo phương pháp sau và sử dụng lớp chiếu sáng http response để nhận trạng thái thay vì một giá trị cố định, chẳng hạn như http_ok ​​sẽ là 200

          Khi xây dựng api, bạn có thể cần phải chuyển đổi dữ liệu từ bộ điều khiển trước khi trả lại cho người dùng ứng dụng của mình, laravel đã hỗ trợ điều này thông qua tài nguyên hùng hồn

          Để tạo một lớp chuyển đổi, chúng tôi chạy lệnh sau

          nghệ nhân php làm: sản phẩm tài nguyên

          Tệp app / http / resources / product.php sẽ có nội dung sau

          Tôi sẽ tùy chỉnh dữ liệu trả về để chỉ có tiêu đề và giá cả

          Trong bộ điều khiển, tôi đã thay đổi nó như sau

          Ngoài việc trả về các dữ liệu như tiêu đề hay giá cả, laravel hỗ trợ thêm các mối quan hệ, dữ liệu … và nhiều thứ nữa, mọi người có thể đọc thêm tài liệu trên laravel.

          Ủy quyền

          Hiện tại có ba cơ chế ủy quyền chính:

Trả lời

Email của bạn sẽ không được hiển thị công khai. Các trường bắt buộc được đánh dấu *