API là gì?

Để giao tiếp và cấu hình hệ thống mạng, các nhà phát triển phần mềm thường sử dụng cổng giao tiếp application programming interfaces (APIs). APIs được sử dụng để hai phần mềm có thể nói chuyện với nhau. Ngoài ra chúng cũng có thể sử dụng để giao tiếp với các thành phần khác trong hệ thống mạng. Nhà phát triển có thể sử dụng API để cấu hình cũng như là giám sát các thành phần trong hệ thống mạng.




API được ví như là người phục vụ, Client thực hiện các phiên gọi API sẽ như khách hàng yêu cầu món ăn đến nhà bếp( Server) thông qua người phục vụ. Khi đó API sẽ đưa các phiên gọi API đó đến Server, Server sẽ chuẩn bị dữ liệu dưỡi một định dạng như XML, JSON,… sau đó sẽ phản hồi lại cho người dùng thông qua API.

Có rất nhiều loại API khác nhau nhưng trong Network Automation tập trung chủ yếu ở hai loại API đó là Northbound API và Southbound API. Hình 2.9 mô tả cách thức hoạt động cơ bản của Northbound API và Southbound API.

Northbound APIs

Northbound APIs thường được sử dụng để giao tiếp với thiết bị Network Controller đến phần mềm quản lý và các công cụ quản lý cấu hình nhứ Ansible, Puppet, Chef,…

Northbound APIs bao gồm hai loại API đó là Synchronous API và Asynchronous API.

Synchronous APIs

Đối với Synchronous API có thể làm cho phần mềm truy vấn API phải chờ đợi phản hồi từ phía Server để xử lý dữ liệu. Vì thế có thể dẫn đến sự gián đoạn dịch vụ hoặc không thể phản hồi từ phía Server.

Asynchronous APIs

Ngược lại với Synchronous API, Asynchronous APIs không cần phải đợi Server phản hồi để thực tiện các chức năng của ứng dụng để xử lý dữ liệu nhận được. Asynchronous APIs cung cấp một cơ chế gọi lại cho phép các phản hồi của API có thể gửi lại vào một khoản thời gian khác, không cần ứng dụng phải đợi đến khi toàn bộ phiên kết nối hoàn tất.



Tóm lại, sự khác biệt giữa Synchronize API và Arsynchronize API là Synchronize API sẽ chờ để nhận dữ liệu từ phía Server phản hồi sau đó mới bắt đầu tiếp tục thực hiện các chức năng khác của chương trình. Còn đối với Arsynchronize API có khả năng cho phép thực hiện các chức năng khác của chương trình mà không cần chờ đợi quá trình gọi API hoàn tất thông qua tính năng gọi lại. Arsynchronize cung cấp cho người dùng một trải nghiệm tốt hơn, người dùng không cần phải đợi một khoản thời gian để nhận thông tin dữ liệu từ phía Server để hoàn thành việc khác.

Southbound APIs

Khi người quản trị mạng thay đổi cấu hình của một thiết bị switch hoặc router trên chương trình quản lý của controller, những thay đổi đó sẽ được đẩy xuống các thiết bị mạng phía dưới thông qua cổng Southbound API, những thiết bị nhận được cấu hình này có thể là router, switch, thậm chí là access point. APIs có thể tương tác với các thành phần trong hệ thống mạng thông qua một cổng có thể được lập trình. Southbound API có thể sửa đổi nhiều thứ hơn không gói gọn trong data plane trên thiết bị.

RESTful API

REST( Representational State Transfer) là một dạng chuyển đổi cấu trúc dữ liệu, một kiểu kiến trúc để viết API. Nó sử dụng phương thức HTTP đơn giản để tạo cho giao tiếp giữa các máy. Vì vậy, thay vì sử dụng một URL cho việc xử lý một số thông tin người dùng, REST gửi một yêu cầu HTTP như GET, POST, DELETE, .v.v. đến một URL để xử lý dữ liệu.

API sử dụng REST thường được gọi là RESTful API. Các RESTful API sử dụng các phương thức HTTP để thu nhập dữ liệu và chỉnh sửa chúng. Các phương thức HTTP sẽ có phần tương tự như các hàm trong SQL sử dụng để lưu trữ cũng như thay đổi dữ liệu. Các phương thức này thường được gọi bằng cái tên CRUD viết tắt cho các chức năng như CREATE, READ, UPDATE và DELETE.

Các phương thức HTTP và ví dụ:


Các phương thức CRUD và ví dụ:



Dựa trên hai bảng so sánh trên thì chúng ta nhận thấy một số điểm chung giữa phương thức HTTP và CRUD.

RESTful API requests & responses

Khi thực hiện một request API cần phải thực hiện yêu cầu đến một điểm đích là nơi chứa tài nguyên hệ thống mạng. Ví dụ như khi ping cần phải có địa chỉ IP đích hoặc domain name được hệ thống phân giải sang IP. Còn đối với APi thì địa chỉ đích sẽ được gọi là URI ( Uniform resource Identifier).

URI sẽ bao gồm hai thành phần chính:

• URL( Uniform Resource Locator) – là một tham chiếu đến tài nguyên hệ thống cụ thể. Giao thức HTTP và HTTPS thường được sử dụng trên trình duyệt web. Ngoài ra còn có một số giao thức khác như FTP, SFTP,… thường được sử dụng với URL.
• URN ( Uniform Resource Name) – dùng để xác định tài nguyên sử như trang web, hình ảnh, tài liệu mà không cần tham chiếu đến giao thức.

Cấu trúc của một URI sẽ bao gồm bốn thành phần con bên trong và sẽ được phân chia như ví dụ sau:
Ví dụ: một URI https://www.example.com/author/book.html#page155 sẽ được chia thành:

• Protocol: Giao thức được sử dụng. Có thể là HTTP, HTTPS hoặc là những giao thức khác.
• Server: Tên domain name của Server hoặc địa chỉ IP
• Resource: Tài nguyên muốn truy xuất
• Parameter: Các tham số được sử dụng để gửi thông tin liên quan đến yêu cầu API.

Khi thực hiện yêu cầu API đến Server và Server sẽ phản hồi về cho người dùng một status code và dữ liệu. Quá trình thực hiện yêu cầu API nếu thành công thì status code phản hồi về sẽ có giá tị là 2xx còn nều thất bài sẽ có giá trị là 4xx hoặc 5xx. Nguyên nhận thất bại thì có thể do phía người dùng ( thông tin đăng nhập sai, dữ liệu truyền đến Server không đúng yêu cầu,…) hoặc có thể do phía Server. Chúng ta có thể dựa vào Status code để kiểm tra lỗi. Một số Status code thường được sử dụng: