Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Web Development

Cách sử dụng Cập nhật mới nhất cho API Marketplace

by
Length:LongLanguages:

Vietnamese (Tiếng Việt) translation by Thai An (you can also view the original English article)

Các thị trường Envato đang bùng nổ, với hơn 600 nghìn thành viên và hơn 65 nghìn tệp!

Một bổ sung tuyệt vời cho thị trường là API, vốn đang trở nên phổ biến hơn mỗi ngày, nhờ vào các bản cập nhật mới nhất! Các nhà phát triển thị trường tuyệt vời của chúng tôi liên tục lắng nghe phản hồi của cộng đồng và đã thêm một số tính năng ngọt ngào vào bản phát hành cạnh!

Hãy chắc chắn kiểm tra một số ứng dụng có sẵn trên web - tất cả đều được API Envato hỗ trợ.

Hôm nay, chúng ta sẽ xem xét các tính năng API mới nhất! Tham gia cùng tôi sau khi nhảy!


API là gì?

Giao diện lập trình ứng dụng (API) là một bộ quy tắc và đặc tả cụ thể mà chương trình phần mềm có thể theo dõi để truy cập và sử dụng các dịch vụ và tài nguyên được cung cấp bởi một chương trình phần mềm cụ thể khác. Nó phục vụ như một giao diện giữa các chương trình phần mềm khác nhau và tạo điều kiện cho sự tương tác của chúng, tương tự như cách giao diện người dùng tạo điều kiện cho sự tương tác giữa con người và máy tính.

Web API

API Web cho phép kết hợp nhiều dịch vụ vào các ứng dụng mới, được gọi là mashup.

Khi được sử dụng trong ngữ cảnh phát triển web, một API thường là một tập hợp các thông báo yêu cầu Giao thức Truyền Siêu văn bản (HTTP) được định nghĩa, cùng với định nghĩa về cấu trúc của các thông điệp phản hồi, thường là trong Ngôn ngữ Đánh dấu Mở rộng (XML) hoặc JavaScript Định dạng đối tượng (JSON).

Trong khi "Web API" hầu như là đồng nghĩa của câu lạc bộ dịch vụ web, xu hướng gần đây đã được di chuyển ra khỏi đơn giản đối tượng truy cập giao thức (SOAP) dựa trên dịch vụ, hướng tới trực tiếp hơn Representational nhà nước chuyển (còn lại) theo phong cách truyền thông. Web API cho phép cho sự kết hợp của nhiều dịch vụ vào các ứng dụng mới được gọi là mashup.


API được sử dụng nhiều?

Hầu hết các nhà phát triển sẽ biết câu trả lời cho câu hỏi này, nhưng đối với những người khác, câu trả lời là một CÓ.

API được tìm thấy ở mọi nơi; chúng phổ biến một phần trong lĩnh vực mạng xã hội! Hầu hết các mạng lớn, bao gồm Twitter và Facebook, cung cấp các API để tương tác với dịch vụ của họ.


Tính năng API mới

Trong hướng dẫn này, chúng tôi sẽ chỉ xem xét các tính năng API mới. Nếu bạn muốn tìm hiểu thêm về các tính năng API hiện có, hãy nhớ xem hướng dẫn của Drew về chủ đề này.

Công cộng

  • mục - Chi tiết cho một mục duy nhất, được chỉ định bởi ID đã cho.
  • item-price - Trả lại giấy phép và giá có sẵn cho ID mặt hàng đã cho.
  • user-items-by-site - Hiển thị số lượng các mục mà tác giả đã bán trên mỗi trang. Yêu cầu tên người dùng, ví dụ như collis.

Riêng tư

  • verify-purchase - Chi tiết mua hàng. Yêu cầu mã mua hàng, ví dụ: xác minh mua: 550e8400-e29b-41d4-a716-446655440000.
  • download-purchase - URL để tải xuống mua hàng. Yêu cầu mã mua hàng, ví dụ: mua hàng tải xuống: 550e8400-e29b-41d4-a716-446655440000

Yêu cầu

Tutorial image

Để bắt đầu với API, bạn sẽ cần một tài khoản Envato Marketplace và một khóa API.

Bạn có thể truy xuất khóa API của mình bằng cách truy cập trang cài đặt tài khoản của bạn.

Tutorial image

Chúng tôi sẽ sử dụng một hàm PHP, được gọi là json_decode; điều này cho phép chúng tôi truy xuất dữ liệu API và chuyển đổi nó thành một mảng. Hàm này được bao gồm trong PHP 5> = 5.2.0.

Có tất cả mọi thứ? Băt đâu nao!


Bước 1 - Xây dựng lớp học của chúng tôi

Hãy bắt đầu bằng cách xây dựng một lớp PHP đơn giản, nó sẽ cho phép chúng ta lấy dữ liệu từ API.

Tạo một thư mục dự án mới và tạo một thư mục khác được gọi là các lớp, để giữ mọi thứ được sắp xếp. Bên trong thư mục này, thêm một tệp PHP mới có tên là envato.api.class.php

Đầu tiên, chúng ta sẽ xây dựng bộ xương cơ bản của lớp của chúng ta:


Bước 2 - Biến toàn cục

Chúng tôi cần một vài biến trong lớp học của chúng tôi để làm cho nó linh hoạt. Để tìm ra biến nào chúng ta cần, chúng ta phải xem xét định dạng url API.

  • Công khai - http://marketplace.envato.com/api/edge/set.json
  • Riêng tư - http://marketplace.envato.com/api/edge/username/api-key/set.json

Như bạn thấy, chúng ta cần tổng cộng bốn biến:

  • Url API
  • Bộ
  • Tên người dùng
  • Mã API

Hãy tạo các biến riêng tư như sau:


Bước 3 - Phương pháp Setter & Getter

Tôi thích sử dụng các phương thức setter và getter khi xây dựng các lớp trong PHP. Vậy chính xác những phương pháp này là gì? Tôi đã thực hiện một ví dụ nhỏ dưới đây:

Mã ở trên sẽ không hoạt động và phải trả lại lỗi sau:

Bởi vì biến được đặt thành riêng tư, chúng tôi không thể truy cập hoặc thay đổi nó. Nếu chúng ta cần thay đổi url API mà không cần chỉnh sửa tệp lớp, chúng ta có thể làm điều gì đó dọc theo các dòng:

Bây giờ chuyển trở lại lớp PHP và thêm hàm, set_api_url.

Vì hàm này nằm trong lớp của chúng ta, chúng ta có thể truy cập và thay đổi biến api_url riêng. Bây giờ trong hướng dẫn này, chúng ta không thực sự cần các getters, nhưng chúng ta hãy tạo một cái để cung cấp cho bạn một sự hiểu biết tốt hơn về khái niệm.

Như bạn có thể suy ra tại thời điểm này, chúng ta không cần một hàm get cho khóa API chẳng hạn. Điều này làm cho lớp của chúng tôi an toàn hơn.


Bước 4 - Hoàn thành phần còn lại của người định cư

Chúng tôi đã hoàn thành một setter, do đó, có ba còn lại và tất cả đều có cấu trúc tương tự.

Đặt tên người dùng

Đặt khóa API

Đặt bộ API

Chúng tôi hiện có thể đặt tất cả các biến như sau:


Bước 4 - Yêu cầu dữ liệu

Hãy xây dựng một hàm sẽ yêu cầu dữ liệu từ API của Envato Marketplace. Chúng tôi bắt đầu bằng cách tạo ra một chức năng công cộng mới được gọi là yêu cầu.

Chúng ta có thể sử dụng kỹ thuật tương tự được sử dụng trong hướng dẫn trước. Để yêu cầu dữ liệu từ API, chúng tôi có thể sử dụng cURL. Hãy bắt đầu bằng cách xây dựng URL API - nếu tên người dùng và khóa API được đặt, chúng tôi yêu cầu một url khác.

Chúng tôi gửi yêu cầu tới API bằng cách sử dụng cURL như sau:

Bây giờ chúng ta có một biến, được gọi là $ ch_data có chứa một chuỗi định dạng JSON. Trước khi chúng ta có thể làm điều gì đó với điều này, chúng ta cần giải mã nó thành một mảng.

Hàm toàn bộ trông giống như sau:


Bước 5 - Kiểm tra chức năng

Hãy thử lớp của chúng tôi và yêu cầu một số dữ liệu từ API:

Tutorial image

Bước 6 - Kiểm tra các tính năng mới của API công khai

Bây giờ lớp của chúng tôi đang hoạt động, đã đến lúc xây dựng một số ví dụ với các tính năng API mới.

Mục

Để yêu cầu thông tin về một mặt hàng trên thị trường, chúng tôi phải cung cấp API có ID mặt hàng. Bạn có thể tìm thấy ID mục trong URL của mục thị trường.

Tutorial image

Bây giờ chúng tôi có ID của chúng tôi, hãy yêu cầu thông tin mục:

Các dữ liệu sau đây phải được trả về:

Bây giờ chúng ta hãy xây dựng một trang đơn giản sẽ hiển thị thông tin ở trên theo cách mà người dùng khác sẽ hiểu nó. Đầu tiên, chúng ta cần gán dữ liệu API cho một biến:

Bây giờ chúng tôi có thể hiển thị dữ liệu từ API theo định dạng sau: $ data ['item'] ['key'].

HTML sau khi PHP được phân tích cú pháp:

Tutorial image

giá cả mặt hàng

Thay vì tạo yêu cầu API mới để tìm hiểu thêm về giá và giấy phép của mặt hàng, chúng tôi có thể chỉ cần thêm nó vào bộ API hiện tại.

Phản hồi của API dưới đây:

Bây giờ chúng ta có thể sử dụng thông tin trả về này trong trang mục của chúng ta.

Tutorial image

người dùng theo từng trang

Để hoàn thành nó, chúng ta sẽ nối thêm số lượng các mục mà người dùng có. Chúng ta chỉ cần thêm nó vào bộ API.

Và phản hồi:

Hãy thêm thông tin này vào trang của chúng tôi.

Tutorial image

Bước 7 - Kiểm tra các tính năng mới của API riêng tư

Để sử dụng các tính năng API riêng tư, bạn cần có tài khoản thị trường và mã mua hàng từ một trong các khách hàng của mình. Đầu tiên chúng ta cần xác định thông tin này.

xác minh mua hàng

Điều này sẽ tự động thay đổi URL API từ chế độ công khai thành bộ riêng tư. Để làm cho mọi thứ năng động hơn một chút, chúng tôi có thể tạo một biểu mẫu nhỏ để người dùng có thể nhập một số thông tin để xác minh giao dịch mua của mình.

Lưu ý: Khi xây dựng trang web của riêng bạn, không sử dụng kiểu nội tuyến như thế này!

Chúng ta có một form cơ bản như sau:

Tutorial image

Bây giờ chúng ta hãy vào phần PHP.

Đầu tiên, chúng ta cần kiểm tra xem biểu mẫu đã được gửi với các trường cần thiết chưa. Nếu bạn đang sử dụng điều này trên một trang web trực tiếp, hãy nhớ thêm xác thực khác để làm cho mọi thứ an toàn hơn.

Và bây giờ là yêu cầu API.

Một phản hồi API hợp lệ sẽ giống như sau:

Nếu yêu cầu không hợp lệ, API sẽ trả về một mảng trống. Nếu chúng tôi nhận được phản hồi từ API, điều đó có nghĩa là mã mua hàng là chính xác. Để đảm bảo an toàn hơn, chúng tôi sẽ khớp nó với id và tên người dùng đã nhập.

Tutorial image

tải xuống mua

Bộ mua hàng tải xuống cho phép bạn tải xuống các giao dịch mua của riêng bạn mà không cần truy cập vào thị trường.

Lưu ý: Giao dịch mua tải xuống chỉ hoạt động khi bạn đang sử dụng khóa API của chính mình và mã mua hàng của sản phẩm bạn đã mua.

Bây giờ chúng ta đã có hộp kiểm của chúng ta, chúng ta hãy thực hiện một số thay đổi cho quá trình xác minh.

Chúng ta sẽ bắt đầu bằng cách tạo một biến mới.

Chúng tôi cũng cần thực hiện một số thay đổi đối với mã còn lại:

Với những thay đổi đó, phản hồi sẽ như sau:


Tổng kết

Tôi hy vọng bạn đã học được một ít về marketplace API của Envato. Nếu vậy, hãy vận dụng kiến thức này và xây dựng vài ứng dụng tuyệt vời! Cảm ơn đã đọc bài viết, và hãy cho chúng tôi biết nếu bạn có bất kỳ câu hỏi hoặc điều lo ngại gì.

Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.