Hướng dẫn API dữ liệu MongoDB

MongoDB bắt đầu như một cơ sở dữ liệu NoSQL có mục đích chung vào năm 2009. Trong những năm qua, sản phẩm đã phát triển thành nhiều hơn một cơ sở dữ liệu. Dịch vụ đám mây, MongoDB Atlas, cung cấp một tập hợp các dịch vụ mà các nhà phát triển có thể sử dụng để giúp việc xây dựng ứng dụng trở nên dễ dàng hơn bao giờ hết. Một trong những tính năng mới này là API dữ liệu Atlas, cho phép các nhà phát triển đã quen làm việc với API REST kết nối với cơ sở dữ liệu của họ qua một giao diện tương tự một cách dễ dàng

Vì MongoDB nhằm mục đích cung cấp trải nghiệm tốt nhất có thể cho nhà phát triển nên việc giúp các nhà phát triển kết nối với công cụ kiểm tra API tốt nhất để khám phá API mới này là điều hợp lý

API dữ liệu bản đồ MongoDB mới

MongoDB cung cấp trình điều khiển cho tất cả các ngôn ngữ lập trình chính và giúp các nhà phát triển phần mềm dễ dàng sử dụng cú pháp mà họ quen thuộc để kết nối với cơ sở dữ liệu của họ. Tuy nhiên, có những trường hợp những trình điều khiển đó không đủ

Một số ngôn ngữ lập trình không có sẵn trình điều khiển. Bash chẳng hạn, không có. Để viết hoặc đọc từ cơ sở dữ liệu, nhà phát triển cần gọi tập lệnh hoặc ứng dụng được viết bằng ngôn ngữ khác. Điều này yêu cầu công việc bổ sung và tạo mã khó bảo trì hơn. Sử dụng API dữ liệu MongoDB mới này, giờ đây có thể sử dụng lệnh `curl` để tương tác với dữ liệu từ một bộ sưu tập. Ví dụ: bản sao Wordle này được viết bằng Bash đọc một từ gồm năm chữ cái ngẫu nhiên từ bộ sưu tập MongoDB để khởi tạo trò chơi. Một trường hợp sử dụng hàng ngày khác là với đường dẫn CI/CD. Là một phần của quy trình, một kỹ sư có thể muốn duy trì một số thông tin về lần chạy mới nhất trong cơ sở dữ liệu

Một trường hợp sử dụng thường xuyên khác là dành cho các ứng dụng ít mã hoặc không có mã. Nếu bạn sử dụng một sản phẩm như Zapier hoặc IFTTT, bạn có thể tạo các luồng dữ liệu trên nhiều ứng dụng khác nhau. Các nền tảng đó cũng có thể kích hoạt lệnh gọi REST tới một URL dựa trên các sự kiện cụ thể. Giờ đây, URL này có thể là điểm cuối API dữ liệu Atlas, cho phép các nền tảng đó ghi dữ liệu trực tiếp vào bộ sưu tập mà không cần ứng dụng của bên thứ ba chuyển tiếp thông tin. Ví dụ: một người có thể viết một mục nhập vào bộ sưu tập MongoDB mỗi khi con mèo của họ sử dụng khay vệ sinh của họ, bằng cách sử dụng một số tích hợp IFTTT. Điều này có thể giúp theo dõi sức khỏe của mèo dễ dàng hơn

Mặc dù việc sử dụng API dữ liệu với IFTTT để theo dõi phân mèo có thể không phải là ưu tiên hàng đầu của mọi người, nhưng cách thiết lập đơn giản tương tự vẫn đúng với mọi công cụ mã thấp hoặc không mã mà bạn có thể sử dụng với API dữ liệu, bao gồm các công cụ tập trung vào doanh nghiệp như GitHub hoặc

Zapier zap sẽ ghi vào MongoDB Atlas mỗi khi yêu cầu kéo được tạo và sau đó tạo sự cố trong Jira

Cuối cùng, là một kỹ sư phần mềm, có những lúc bạn chỉ muốn truy cập cơ sở dữ liệu của mình một cách nhanh chóng. Cho dù đó là để kiểm tra mã của bạn hay dọn sạch bộ sưu tập sau khi chạy thử, đôi khi việc sử dụng API REST sẽ có ý nghĩa hơn

Sử dụng API dữ liệu

API dữ liệu hiện dễ sử dụng hơn bao giờ hết trong MongoDB Atlas. Với việc tích hợp nút Run in Postman, bạn có thể dùng thử API chỉ bằng một cú nhấp chuột. Đây là cách

1. Đăng nhập vào tài khoản MongoDB Atlas của bạn. Nếu chưa có, bạn có thể tạo miễn phí
2. Tạo một cụm theo các bước trong tài liệu
3. Từ thanh điều hướng bên trái, chọn API dữ liệu và chuyển đổi tính năng này trên cụm của bạn
4. Nhấp vào nút Kiểm tra API của bạn màu xanh lục ở góc trên bên phải. Điều này sẽ mở ra một phương thức nơi bạn sẽ thấy nút Run in Postman

Bạn có thể kiểm tra API của mình trong Postman bằng cách sử dụng nút Chạy trong Postman từ Giao diện người dùng Atlas

Thao tác này sẽ chuyển bộ sưu tập API dữ liệu của MongoDB sang không gian làm việc của riêng bạn. Từ đó, bạn sẽ có thể chọn môi trường được tạo cho mình

Bạn có thể tìm hiểu thêm về API dữ liệu và cách bạn có thể sử dụng nó với Postman trong tập podcast của MongoDB có Nhà phát triển cấp cao Postman Advocate Arlemi Turpault

Cách MongoDB Atlas tích hợp với Postman

Nhóm Postman đã làm rất tốt trong việc giúp các nhà cung cấp phần mềm tích hợp nút Run trong Postman với nền tảng của họ một cách dễ dàng và trực quan. Việc thêm nút vào ứng dụng chỉ đơn giản là sử dụng mã từ tài liệu trong Giao diện người dùng Atlas

Mã soạn sẵn bao gồm thẻ div và tập lệnh để tải lên bất kỳ phụ thuộc cần thiết nào

Hành vi mặc định cho nút Run in Postman nhắc người dùng rẽ nhánh một bộ sưu tập. Bạn cũng có thể định cấu hình các hành động khác nhau, chẳng hạn như để nhập bộ sưu tập

Tùy chọn rẽ nhánh cho phép người dùng tạo nhánh của Bộ sưu tập Postman và họ sẽ được thông báo bất cứ khi nào có thay đổi trong bộ sưu tập gốc. Điều này có thể hữu ích cho các API có thể thay đổi trong tương lai hoặc để dễ dàng thông báo cho người dùng về các điểm cuối mới được thêm vào API

Mặt khác, hành động nhập sẽ sao chép bộ sưu tập vào giao diện người dùng của người dùng và họ sẽ có thể sử dụng nó trực tiếp từ ứng dụng máy tính để bàn nếu họ đã cài đặt nó trên hệ thống của mình

MongoDB đã quyết định sử dụng hành vi mặc định, theo khuyến nghị của Postman. Bằng cách này, mọi thay đổi đối với Bộ sưu tập Postman do nhóm của chúng tôi thực hiện sẽ tự động được cung cấp cho tất cả người dùng của chúng tôi. Phân nhánh này sẽ mở trong một tab mới và người dùng vẫn có quyền truy cập vào giao diện người dùng Atlas để nhanh chóng sao chép và dán các giá trị không được điền sẵn trong môi trường

Nói về môi trường, chúng tôi muốn thêm một cái vào bộ sưu tập để người dùng Postman có thể sử dụng các trường điền sẵn cần thiết cho API. Tuy nhiên, vì mục đích bảo mật, không phải tất cả các trường đều được điền trước. Hiện tại, chỉ có điểm cuối URL được lấp đầy như một phần của môi trường

Sau khi tập lệnh được tải, việc tạo môi trường trở nên đơn giản

_pm('env.create', 'Data API', {key: value});

Với môi trường mới này được tạo, các nhà phát triển phần mềm chuyển đổi bộ sưu tập API dữ liệu có một môi trường “API dữ liệu” mới mà họ có thể sử dụng để tương tác với API

Tại sao chúng tôi thích nút Run in Postman. trao cho các nhà phát triển siêu năng lực

Postman là nền tảng tốt nhất để các nhà phát triển phần mềm thử nghiệm API của họ và nhóm Postman đã giúp dễ dàng tích hợp nút Chạy trong Postman của họ như một phần sản phẩm của chúng tôi. Chúng tôi hiện đang cung cấp công cụ tốt nhất có sẵn trực tiếp từ ứng dụng của mình với tính năng mới này, cung cấp cho các nhà phát triển phần mềm trải nghiệm liền mạch. Điều này mang lại cho các nhà phát triển những siêu năng lực cần thiết để xây dựng các ứng dụng mà không phải thực hiện quá nhiều công việc nặng nhọc

Bạn có thể kiểm tra API dữ liệu Atlas ngay bây giờ bằng tài khoản miễn phí trên MongoDB Atlas hoặc bạn có thể khám phá trực tiếp bộ sưu tập công khai Postman do nhóm MongoDB duy trì

API dữ liệu trong MongoDB là gì?

Làm cách nào để sử dụng API trong MongoDB?

Làm cách nào để lưu trữ dữ liệu API trong MongoDB?

MongoDB có API không?