#postman

How to Build API Documentation From Scratch [A Roadmap for Technical Writers]

Bài viết mô tả quá trình xây dựng tài liệu API công khai từ zeros cho một sản phẩm thực, bắt đầu bằng việc thu thập yêu cầu từ đội phát triển và xác định phạm vi endpoints cần документировать. Nguyên nhân kỹ thuật chính là sự thiếu một mô tả chuẩn hóa, dẫn đến việc nhóm phải viếtруч OpenAPI/Swagger specification bằng tay trước khi tạo ra tài liệu. Sau khi có file spec, tác giả sử dụng công cụ như Redoc hoặc Stoplight để render HTML, đồng thời tích hợp Postman collection và các ví dụ mã trong các ngôn ngữ như JavaScript, Python và Go để tăng tính thực tiễn. Hệ quả là thời gian tích hợp API của khách hàng giảm khoảng 30% và số ticket hỗ trợ liên quan đến việc hiểu endpoint giảm hơn một nửa trong vòng ba tháng sau khi tài liệu được công bố. Điều đáng học là nên bắt đầu bằng việc viết spec OpenAPI, giữ nó trong kho Git để có thể version control, tự động hóa quá trình build qua CI/CD và luôn tham khảo phản hồi từ các developer thực tế để cải tiến liên tục.

No Newman PASS, No Output: How I Made My API Drift Healer Safer

Tác giả chia sẻ cách xây dựng công cụ "API Drift Healer" an toàn hơn sau khi một thay đổi nhỏ phá vỡ bài test Postman. Thay vì chỉ viết lại JSON, công cụ này còn chứng minh được việc sửa lỗi.

Những lỗi nhỏ trong API có thể gây ra sự cố lớn khi không kiểm tra đúng cách, và bài viết này cung cấp cách hiệu chỉnh một công cụ "healer" API để tránh tình trạng không phát hiện sai sót khi thay đổi nhỏ mà vẫn đảm bảo độ tin cậy.

Postman for Business Analysts: The One Tool That Makes API Discussions Easier

Postman không chỉ dành cho developer mà còn hữu ích cho business analyst nhờ khả năng đơn giản hóa các thảo luận về API.

Lập trình viên nên đọc bài này để hiểu cách Postman không chỉ là công cụ phát triển API mà còn là công cụ mạnh mẽ giúp báo cáo, phân tích yêu cầu và hợp tác hiệu quả với các chuyên gia kinh doanh, từ đó tiết kiệm thời gian và tránh những hiểu lầm về API trong quá trình phát triển.

Auto-Healing Postman Tests from OpenAPI Drift

Bài viết mô tả việc chuyển công cụ API Drift Healer từ các test YAML sang bộ sưu tập Postman để tự động sửa chữa khi API thay đổi so với OpenAPI spec. Nguyên nhân kỹ thuật là khi định nghĩa API trong OpenAPI drift (thay đổi trường, loại dữ liệu hoặc endpoint) mà các test Postman vẫn dựa trên schema cũ, dẫn đến lỗi xác nhận không liên quan đến lỗi backend. Hệ quả là các test thất bại thường xuyên, gây nhiễu trong pipeline CI/CD và làm team bỏ thời gian để debug những thay đổi vô hại. Tác giả giải thích cách sử dụng script pre‑request trong Postman cùng với Newman để so sánh schema thực tế với OpenAPI, tự động cập nhật hoặc bỏ qua các trường đã drift, từ đó “auto‑heal” bộ test mà không cần sửa tay mỗi lần spec thay đổi. Bài học chính là khi triển khai test API dựa trên hợp đồng, nên đầu tư vào lớp tự động hóa để phát hiện và điều chỉnh drift sớm, thay vì dựa vào việc sửa test thủ công mỗi khi có thay đổi nhỏ trong API.

Bài viết này giúp tự động sửa chữa các bài kiểm tra Postman khi API thay đổi so với OpenAPI spec.