Hướng dẫn sử dụng APIS không dành cho lập trình viên

Ngay cả khi bạn không biết API là gì, bạn chắc chắn đã tương tác với một API.

Ngày nay, chúng ta coi sự kết nối giữa công nghệ là chủ yếu. Chẳng hạn, chúng tôi không đặt câu hỏi khi chúng tôi sử dụng OpenTable để đặt chỗ tại một nhà hàng gần đó.

Ngoài ra, nếu bạn sử dụng kay.com để đặt chuyến bay, có lẽ bạn chưa bao giờ tự hỏi, Đợi một chút, làm sao kay biết JetBlue có chỗ ngồi mở trong 27A?

Cuối cùng, bất cứ khi nào bạn cần các ứng dụng để giao tiếp với nhau, bạn cần một API hoặc giao diện lập trình ứng dụng.

Ở đây, chúng ta sẽ khám phá API là gì và tại sao bạn cần sử dụng API. Ngay cả khi bạn không phải là lập trình viên và không nhu cầu để biết thuật ngữ kỹ thuật sâu rộng, bạn vẫn nên hiểu những điều cơ bản, vì ngày nay, tích hợp giữa công nghệ thường là thành phần quan trọng trong công việc của bất kỳ ai.

API là gì?

Theo định nghĩa cơ bản nhất của nó, một API cho phép một phần mềm nói chuyện với một phần mềm khác.

Để hiểu API hoạt động, hãy xem xét một ví dụ thực tế – tích hợp của HubSpot với typeform. Typeform, một công cụ cung cấp các câu đố, biểu mẫu liên hệ và biểu mẫu đăng ký sẵn sàng cho thiết bị di động, cần tích hợp với API Forms của HubSpot để tương tác với công cụ biểu mẫu và gửi liền mạch từ các biểu mẫu typeform vào HubSpot CRM.

Để làm điều này, API của typeform và API của HubSpot cần nói chuyện. Tích hợp có thể đóng vai trò là người dịch, đảm bảo mỗi thông tin của API được dịch chính xác cho ứng dụng khác – trong trường hợp này, tích hợp có thể đảm bảo rằng các trường biểu mẫu Kiểu chữ được ánh xạ chính xác đến các trường HubSpot tương ứng.

Isaac Takushi, Chuyên gia hỗ trợ nhà phát triển HubSpot giải thích – “Bạn có thể nghĩ về API và ‘điểm cuối’ mà chúng bao gồm là điểm truy cập cho thông tin khác nhau. Tuy nhiên, mỗi điểm cuối API chỉ có thể có một công việc cụ thể. hỗ trợ tích hợp mạnh mẽ, nhiều mặt. ”

Chẳng hạn, kay.com cần một số API để liên lạc với các hệ thống của JetBlue. Khi bạn tìm kiếm “Boston to Charlotte” trong kay, API đặt chỗ của JetBlue về cơ bản sẽ nhận được yêu cầu này từ kayak, lấy thông tin liên quan đến yêu cầu đó và gửi lại. Tuy nhiên, kay sẽ cần nó sở hữu API hoặc mã để hiểu và hành động dựa trên thông tin API JetBlue trả về.

Cách sử dụng API

Để sử dụng API, bạn thường cần khóa API, vì hầu hết các API đều yêu cầu API. Hãy xem tài liệu API cho các yêu cầu truy cập. Sau đó, tìm một ứng dụng khách HTTP trực tuyến, chẳng hạn như Postman hoặc Runscope. Các công cụ này sẽ giúp bạn truy cập API bằng khóa API của bạn với rất ít mã hóa được yêu cầu.

Để sử dụng API, bạn sẽ muốn xem tài liệu API API để biết các yêu cầu truy cập. Chẳng hạn, API Danh bạ của HubSpot yêu cầu xác thực:

Tương tự, bạn sẽ cần một khóa API để truy cập API của Google, API của Facebook và API của Twitter.

Khi bạn có yêu cầu truy cập, bạn có thể sử dụng một công cụ như Postman hoặc Runscope để tương tác thủ công với API. Các công cụ của bên thứ ba hoặc “ứng dụng khách REST” này cho phép bạn thực hiện các yêu cầu một lần đến các điểm cuối API mà không cần mã hóa. Chúng thật tuyệt khi cảm nhận về những gì hệ thống phụ trợ của bạn có thể tự động làm. Kiểm tra tài nguyên này về cách thực hiện yêu cầu API đầu tiên của bạn với Postman.

Nếu bạn chưa sẵn sàng để nhảy vào phần cuối sâu với ứng dụng khách REST, hãy thử bấm những điều sau vào trình duyệt của bạn:

Đây là điểm cuối API công khai từ dịch vụ REST Country miễn phí. Cụ thể, chúng tôi đang sử dụng điểm cuối “Tên”, chấp nhận tên quốc gia làm truy vấn tìm kiếm. Một tìm kiếm thành công sẽ trả về các trận đấu quốc gia tiềm năng, cùng với thông tin chính về mỗi quốc gia. Trong trường hợp này, chúng tôi đang tìm kiếm các quốc gia có tên có chứa từ thống nhất.

Bạn sẽ thấy khối dữ liệu JSON sau đây được trả về:

Xin chúc mừng! Bạn vừa thực hiện một yêu cầu API từ trình duyệt của bạn!

Điểm cuối trả về dữ liệu thô (được định dạng trong JSON) trên các quốc gia có “thống nhất” trong tên.

Nó có thể trông không đẹp, nhưng hãy nhớ rằng API được thiết kế cho các ứng dụng, không yêu cầu kiểu dáng mà con người mong đợi trên trang web HTML. Mặc dù bạn có thể dễ dàng Google “các quốc gia bắt đầu bằng ‘thống nhất’, nhưng các ứng dụng không thể. Họ có thể phải dựa vào các dịch vụ như REST Country để tìm kiếm thông tin đó.

Nếu bạn không chắc chắn liệu bạn có nên sử dụng các nhà phát triển nội bộ của mình để tạo API hay tìm kiếm bên ngoài hay không, hãy xem API của bên thứ nhất so với bên thứ ba: Những điều bạn cần biết.

Được xuất bản lần đầu vào ngày 17 tháng 5 năm 2019 7:00:00 SA, cập nhật ngày 17 tháng 5 năm 2019.

Source link