Lab : Sử dụng Postman tương tác với Meraki API

[huynhvanmanhtien]

Trong bài lab này chúng ta sẽ sử dụng X-Meraki-API-Key để cấp quyền lời gọi REST API đến Meraki cloud, hướng dẫn cơ bản để tương tác với mạng và thiết bị Meraki. Meraki được tổ chức theo cấp bậc, Organizations ở mức độ cao nhất và mỗi organization có ID duy nhất làm thuộc tính. Để có thể tương tác với organization mong muốn, ứng dụng phải xác định đúng organization id. Networks là thành phần con trong Organizations và cũng có ID duy nhất khi được xây dựng. Các cấu hình có thể được đặt qua API cho những mạng mong muốn. Thêm vào đó Devices có thể lấy và cấu hình, trên Devices có id duy nhất nhưng tên thược tính thường được sử dụng là serial thay vì id.

Phần chuẩn bị:

Mở git bash và tạo thư mục để lưu trữ code, postman collection và environment

[FONT=Calibri][FONT=Times New Roman]$cd ~[/FONT][/FONT]
[FONT=Calibri][FONT=Times New Roman]$mkdir meraki_code[/FONT][/FONT]
[FONT=Times New Roman]$cd meraki_code[/FONT]

Lấy repository và đưa vào thư mục hiện tại:

$git clone https://github.com/CiscoDevNet/meraki-code

Mở Postman và đem Collection và Environment được đặt trong thư mục meraki-code/postman
Ở góc bên trái chọn Import

Chọn file

Cuối cùng là di chuyển đến thư mục meraki-code/postman, chọn cả hai file bắt đầu với Meraki Dashboard API và mở chúng

Vậy là chúng ta đã xong phần chuẩn bị.

Thêm Meraki API key vào Postman environment:

Góc bên phải của Postman chúng ta nhấn vào biểu tượng có hình bánh răng

Chọn Meraki Dashboard API:

Chỗ ô X-Cisco-Meraki-API-Key thêm vào: 6bec40cf957de430a6f1f2baa056b99a4fac9ea0
Chỗ ô baseUrl thêm vào: https://api.meraki.com/api/v0
Cuối cùng là nhấn Update để lưu lại các thay đổi.

Lấy Organization ID:

Góc bên trái của Postman chọn phần Collection và mở Meraki Dashboard API collection

Mở thư mục Organization và chọn List the organization that user has privileges on
Phần environment bên phải chọn Meraki Dashboard API
Nhấn Send. X-Cisco-Meraki-API-Key có giá trị của biến {{X-Cisco-Meraki-API-Key}} ở tab Headers.
Kết quả:

Cuối cùng là bôi đen ID của DeLab. Nhấn chuột phải vào phần được bôi đen và chọn Set: Meraki Dashboard API và chọn organizationId

Lấy networks trong organization:

Phần Collection chúng ta đi đến folders Networks và chọn List of network in organization
Chọn Send. Qua tab Headers để xem thông tin được gửi kèm bao gồm X-Cisco-Meraki-API-Key và organizationId được sử dụng ở phần Url

Chúng ta sẽ bôi đen id của đối tượng có tên là DevNetLab
Nhấn chuột phải vào phần text được bôi đen và chọn Set: Meraki Dashboard API, chọn networkId

Lấy các thiết bị trong mạng:

Sau khi có được id của mạng mong muốn, ta lấy các thiết bị trong mạng thì thực hiên như sau. Tìm đến folder Device và chọn List the devices in a network.
Chọn Send.
Kết quả:

Chọn thiết bị nào có model bắt đầu từ MR và bôi đen phần serial
Nhấn chuột phải vào phần bôi đen và chọn Set: Meraki Dashboard API, chọn Serial.

Lấy thông tin thiết bị:

Cùng folder Device chọn Return a single device
Nhấn Send.
Kết quả:

Lấy thông tin SSID:

Trong phần Collection, mở folder SSID và chọn List the SSIDs in a network
Nhấn gửi.
Kết quả:

Hoàn thành.

Thank you.

Nguồn : VNPRO