DEV Community

Cover image for APIDOG Cập nhật tháng 6: Luồng công việc CLI trợ lực AI, Nhập liệu mượt mà hơn, Tự động làm mới OAuth 2.0
Sebastian Petrus
Sebastian Petrus

Posted on • Originally published at apidog.com

APIDOG Cập nhật tháng 6: Luồng công việc CLI trợ lực AI, Nhập liệu mượt mà hơn, Tự động làm mới OAuth 2.0

Các bản cập nhật tháng 6 giúp quy trình làm việc API hằng ngày dễ tự động hóa và ổn định hơn: CLI sẵn sàng cho AI, nhập dữ liệu sạch hơn, tự động làm mới OAuth 2.0 và nhiều cải tiến nhỏ dựa trên phản hồi người dùng.

Dùng thử Apidog hôm nay

Bản phát hành này tập trung vào các điểm thường gây mất thời gian trong dự án API: cho tác nhân AI truy cập tài nguyên dự án có cấu trúc, giảm dọn dẹp sau khi import, giữ request OAuth chạy liên tục, và tối ưu các tác vụ kiểm thử hoặc cấu hình lặp lại.

Dưới đây là các thay đổi chính và cách áp dụng chúng vào workflow hằng ngày.

Các bản cập nhật mới

Apidog CLI hỗ trợ quy trình API có AI tham gia

Apidog CLI đang trở thành lớp thực thi cho các quy trình API được hỗ trợ bởi AI.

Thay vì để người dùng hoặc tác nhân AI thao tác dựa trên mô tả rời rạc, CLI giúp AI làm việc với tài nguyên Apidog thật theo cách có cấu trúc hơn: đọc tài nguyên dự án, ghi lại thay đổi, xác thực thao tác, xuất dữ liệu và chạy kiểm thử.

Bạn có thể dùng CLI trong các tình huống như:

  • Cho tác nhân AI đọc ngữ cảnh dự án Apidog trước khi đề xuất thay đổi.
  • Chạy test cases từ quy trình tự động.
  • Cho scenario tham chiếu endpoints, test cases hoặc scenarios khác.
  • Xuất dữ liệu ở định dạng gốc hoặc OpenAPI với phạm vi kiểm soát chi tiết hơn.

Một workflow thực tế có thể triển khai như sau:

  1. Chuẩn bị tài nguyên API trong Apidog: endpoints, test cases, scenarios.
  2. Dùng Apidog CLI làm lớp thực thi để đọc hoặc xuất tài nguyên cần thiết.
  3. Cho tác nhân AI tạo hoặc đề xuất thay đổi dựa trên tài nguyên có cấu trúc.
  4. Xác thực thay đổi bằng test cases hoặc scenarios.
  5. Chỉ ghi lại thay đổi khi kết quả kiểm thử đạt yêu cầu.

Khi kết hợp với Apidog Skills, CLI giúp tác nhân AI có hướng dẫn rõ ràng hơn và giới hạn thao tác an toàn hơn. Thay vì phỏng đoán từ tài liệu không có cấu trúc, tác nhân có thể hiểu cách sử dụng tài nguyên Apidog, xác thực thay đổi trước khi ghi và hoàn thành tác vụ API có kiểm soát hơn.

Hãy xem CLI như cầu nối giữa chỉ dẫn AI bằng ngôn ngữ tự nhiên và các tài nguyên dự án Apidog có cấu trúc.

Cải tiến nhập và xuất dữ liệu

Bản phát hành này cải thiện các quy trình import/export, đặc biệt cho nhóm đang di chuyển dữ liệu từ Postman hoặc duy trì đặc tả API bằng OpenAPI và Swagger.

Khi nhập dữ liệu qua Postman API, Apidog hiện có thể xóa khoảng trắng khỏi tên biến. Điều này giúp giảm lỗi do biến có tên không nhất quán hoặc khó sử dụng trong các bước tiếp theo.

Khi nhập workspace qua Postman API, Apidog cũng có thể đổi tên các workspace "My Workspace" dựa trên người tạo workspace. Với nhóm import nhiều workspace, việc này giúp dữ liệu sau khi nhập dễ nhận diện và tổ chức hơn.

OpenAPI và Swagger cũng được hỗ trợ tốt hơn. Apidog hiện hỗ trợ tham số kiểu object và tham số kiểu reference trong quá trình import/export, giúp giữ lại cấu trúc đặc tả API đầy đủ hơn và giảm chỉnh sửa thủ công.

Trước đây Hiện tại
Biến đã nhập có thể cần dọn dẹp thủ công. Import qua Postman API có thể xóa khoảng trắng khỏi tên biến.
Nhiều workspace có thể cùng tên hoặc khó phân biệt. Workspace mơ hồ như "My Workspace" có thể được đổi tên để dễ nhận diện hơn.
Tham số OpenAPI phức tạp có thể cần chỉnh lại sau import/export. OpenAPI/Swagger hỗ trợ tham số kiểu object và reference.

Checklist nên dùng sau khi import:

  • Kiểm tra tên biến môi trường hoặc collection.
  • Xác nhận workspace đã được đặt tên dễ hiểu.
  • Mở lại các endpoint có tham số phức tạp để xác nhận schema được giữ đúng.
  • Chạy test cases liên quan để phát hiện lỗi do dữ liệu di chuyển.

OAuth 2.0 hỗ trợ tự động làm mới token

Xác thực OAuth 2.0 hiện hỗ trợ tự động làm mới token.

Khi access token sắp hết hạn hoặc đã hết hạn, Apidog có thể tự động làm mới token để request tiếp tục chạy mà không cần xác thực lại thủ công hoặc copy token mới.

Tính năng này hữu ích khi bạn thường xuyên debug API được bảo vệ bằng OAuth. Thay vì bị ngắt luồng mỗi khi token hết hạn, bạn có thể duy trì phiên làm việc ổn định hơn trong lúc kiểm thử.

Cách áp dụng trong workflow:

  1. Cấu hình OAuth 2.0 cho request hoặc môi trường liên quan.
  2. Đảm bảo thông tin cần thiết cho refresh token được thiết lập đúng.
  3. Chạy request như bình thường.
  4. Khi token hết hạn, để Apidog tự động làm mới thay vì thao tác thủ công.
  5. Dùng lại cùng cấu hình cho test cases hoặc debugging lặp lại.

Điều này giúp giảm gián đoạn xác thực trong quá trình debug API, kiểm thử và xác thực request lặp lại.

Cải tiến dựa trên phản hồi người dùng

Tương thích tốt hơn với MCP Client

Apidog đã cải thiện khả năng tương thích với MCP Client và có thể phân tích các schema không chuẩn đáng tin cậy hơn.

Điều này hữu ích khi bạn kết nối với MCP server hoặc công cụ có output schema không tuân thủ hoàn toàn định dạng mong đợi. Thay vì thất bại sớm do khác biệt schema, Apidog có thể xử lý nhiều phản hồi MCP thực tế hơn và tăng tỷ lệ thành công khi tích hợp hoặc debug công cụ.

Cách dùng thực tế:

  • Kết nối MCP Client với server hoặc tool cần kiểm tra.
  • Gửi request hoặc thao tác tích hợp như bình thường.
  • Nếu schema không chuẩn, kiểm tra phản hồi đã được parse đúng chưa.
  • Dùng kết quả parse để tiếp tục debug thay vì phải sửa schema thủ công ngay từ đầu.

Tìm kiếm bước tĩnh theo tên trong bộ kiểm thử

Khi thêm bước tĩnh vào test suite, bạn hiện có thể tìm kiếm theo tên.

Điều này hữu ích với dự án có nhiều endpoints, test cases hoặc scenarios. Thay vì duyệt danh sách dài, bạn có thể tìm trực tiếp bước cần thêm.

Workflow đề xuất:

  1. Mở test suite cần chỉnh sửa.
  2. Chọn thêm bước tĩnh.
  3. Nhập tên endpoint, test case hoặc scenario cần tìm.
  4. Thêm bước phù hợp vào suite.
  5. Chạy lại suite để xác nhận thứ tự và dữ liệu đầu vào.

Tác vụ lên lịch có thêm tùy chọn “Mỗi 8 giờ”

Scheduled tasks hiện có thêm tùy chọn "Mỗi 8 giờ".

Khoảng thời gian này phù hợp cho:

  • Kiểm thử hồi quy định kỳ trong ngày.
  • Kiểm tra API theo kiểu monitoring.
  • Xác thực tích hợp theo chu kỳ.
  • Phát hiện lỗi sớm trước khi đến cuối ngày làm việc.

Ví dụ cách áp dụng:

  1. Tạo hoặc chọn test suite cần chạy định kỳ.
  2. Mở phần cấu hình lịch chạy.
  3. Chọn tần suất "Mỗi 8 giờ".
  4. Kiểm tra kênh nhận báo cáo hoặc kết quả test.
  5. Theo dõi lỗi lặp lại để xử lý sớm.

Apidog Web App hỗ trợ cấu hình header được tự động tạo

Apidog Web App hiện hỗ trợ cấu hình các header được tự động tạo.

Điều này giúp người dùng Web App kiểm soát request tốt hơn và căn chỉnh header với yêu cầu của nhóm hoặc dự án.

Bạn có thể dùng tính năng này khi:

  • Dự án có quy ước header riêng.
  • Một số header tự động cần được bật, tắt hoặc điều chỉnh.
  • Nhóm muốn đồng nhất hành vi request giữa các thành viên.
  • Workflow debug chạy trực tiếp trên trình duyệt.

Sửa lỗi và cải tiến nhỏ hơn

Tháng này cũng có nhiều bản sửa lỗi và cải tiến nhỏ:

  • Cải thiện hiệu suất khi chọn các scenario kiểm thử lớn vào nhánh con, giảm khả năng timeout.
  • Danh sách nhánh sprint và nhánh chung hỗ trợ hiển thị ID nhánh và cho phép sao chép.
  • Hiển thị thông báo thân thiện hơn khi macOS không thể gửi request nội mạng.
  • Sửa lỗi URL cơ sở dịch vụ không được import và endpoint không được liên kết với service được chỉ định khi import lại dữ liệu Apidog vào module mới.
  • Sửa lỗi OAuth 1.0 được cấu hình thêm vào request header nhưng thực tế không được thêm.
  • Sửa lỗi code request endpoint được tạo không hoạt động đúng khi Basic Auth dùng biến tiếng Trung.
  • Sửa lỗi code request được tạo dùng HTTPS không chính xác khi endpoint dùng HTTP.
  • Sửa lỗi chạy CLI scenario có thể báo "Unexpected token" khi một bước scenario tham chiếu response body dạng raw.
  • Sửa lỗi chi tiết test report vẫn hiển thị đang chạy sau khi automated test scenario bị chấm dứt bất thường.
  • Sửa lỗi report tương ứng không hiển thị trong danh sách test report sau khi chạy scenario cases trong thư mục gốc.
  • Sửa lỗi refresh Apidog Web App tự động chuyển dự án về nhánh chính.
  • Sửa lỗi tùy chọn lọc tag không có nội dung trong quá trình import nhánh và khi chèn endpoint vào Markdown.
  • Sửa lỗi service không mặc định bị thêm lặp lại khi import file Apidog có nhiều module và service.
  • Sửa lỗi tag tài liệu Markdown không được import chính xác khi import dữ liệu Apidog.
  • Sửa lỗi conflict vẫn hiển thị sau khi merge endpoints vào nhánh chính trong một số trường hợp.
  • Sửa lỗi UI có thể xảy ra trong một số trường hợp khi debug endpoint SSE.
  • Sửa lỗi thống kê dự án On-Premises chỉ tính dữ liệu từ module mặc định.
  • Sửa lỗi import file Apidog đa module từ trang chi tiết nhóm đưa endpoint sai vào module mặc định.
  • Sửa lỗi thay đổi biến mất trong một số trường hợp sau khi gửi sửa đổi.
  • Sửa lỗi thông báo không chính xác trong luồng xác minh email khi đổi mật khẩu.

Ý nghĩa thực tế cho nhóm API

Nhìn chung, các cập nhật này giúp Apidog phù hợp hơn với workflow có sự kết hợp giữa con người, tác nhân AI, đặc tả API và kiểm thử tự động.

Lĩnh vực Cải tiến Tác động thực tế
CLI hỗ trợ AI CLI giúp tác nhân AI thao tác trên tài nguyên Apidog thật, chạy test cases, tham chiếu tài sản hiện có và kiểm soát export tốt hơn. AI có ngữ cảnh dự án có cấu trúc, giảm phỏng đoán.
Import/export Postman API import có thể làm sạch tên biến và làm rõ tên workspace; OpenAPI/Swagger hỗ trợ tham số object và reference. Ít dọn dẹp hơn sau migration, giữ đặc tả API đầy đủ hơn.
Xác thực OAuth 2.0 token có thể tự động refresh. Giảm gián đoạn khi debug và kiểm thử API.
MCP MCP Client parse được nhiều schema không chuẩn hơn. Tích hợp tốt hơn với MCP server và tool thực tế.
Kiểm thử Tìm bước tĩnh theo tên và scheduled task hỗ trợ chu kỳ 8 giờ. Thiết lập test suite nhanh hơn, chạy kiểm thử định kỳ linh hoạt hơn.
Web App Header tự động có thể được cấu hình. Kiểm soát request tốt hơn trong workflow trên trình duyệt.

Một lộ trình áp dụng đơn giản:

  1. Rà soát workflow API hiện tại: import, auth, test, automation.
  2. Dùng CLI cho các tác vụ có thể tự động hóa hoặc có AI tham gia.
  3. Kiểm tra lại quy trình import từ Postman/OpenAPI để giảm cleanup.
  4. Bật hoặc cấu hình OAuth 2.0 auto refresh cho API cần debug thường xuyên.
  5. Cập nhật test suite với tìm kiếm bước tĩnh và lịch chạy 8 giờ nếu phù hợp.
  6. Chuẩn hóa header tự động trong Web App cho nhóm.

Kết quả là workflow vận hành rõ ràng hơn: tác nhân AI có ngữ cảnh dự án tốt hơn, dữ liệu import ít cần chỉnh sửa hơn, request OAuth ít bị gián đoạn hơn và nhóm có nhiều quyền kiểm soát hơn với kiểm thử định kỳ cũng như cấu hình request.

Tham gia thảo luận

Kết nối với các kỹ sư API và đội ngũ Apidog:

  • Tham gia cộng đồng Discord của chúng tôi để thảo luận và hỗ trợ theo thời gian thực.
  • Tham gia cộng đồng Slack của chúng tôi để trao đổi kỹ thuật.
  • Theo dõi chúng tôi trên X (Twitter) để nhận các bản cập nhật mới nhất.

P.S. Để xem đầy đủ chi tiết về tất cả bản cập nhật, hãy đọc Nhật ký thay đổi của Apidog.

Trân trọng,

Đội ngũ Apidog

Top comments (0)