Hợp đồng API của bạn có thể đang nằm ở ba nơi cùng lúc: một sơ đồ trong wiki, một collection Postman được export từ quý trước, và một tài liệu Markdown đã lệch khỏi service đang chạy. Khi các nguồn này không thống nhất, team phải đoán. Và đoán mò là cách nhanh nhất để làm hỏng tích hợp.
Dùng thử Apidog ngay hôm nay
Cách xử lý là coi đặc tả API như code: viết OpenAPI spec, commit vào Git, review bằng pull request, rồi dùng chính file đó để tạo mock, test, tài liệu và SDK. Khi đó spec không còn là tài liệu phụ trợ, mà trở thành hợp đồng kỹ thuật mà frontend, backend, QA và đối tác cùng dựa vào.
Bài viết này hướng dẫn cách triển khai workflow “spec-as-code” với OpenAPI, Git và các bước kiểm soát thay đổi thực tế.
Spec-as-code nghĩa là gì
