API (Application Programming Interface) là cách phần mềm nói chuyện với phần mềm khác theo hợp đồng rõ: bạn gửi yêu cầu đúng format, nhận dữ liệu hoặc kết quả.
Ví dụ đời thường
Bạn gọi món theo thực đơn (API). Bạn không vào bếp tự lấy (không đụng DB nội bộ). Thực đơn quy định món nào order được.
Trên web, nhiều API dùng HTTP: GET lấy dữ liệu, POST gửi dữ liệu. Phản hồi hay gặp dạng JSON.
Liên hệ AI: nhiều chatbot cũng gọi API model — AI là gì?, AI Agent.

Thử một request thật
GitHub có API công khai cho thông tin repository. Mở Terminal và chạy:
curl --fail-with-body https://api.github.com/repos/python/cpython
Kết quả là JSON. Hãy tìm ba trường name, html_url và description. Đây là một request GET: URL là endpoint; JSON trả về là response. API có thể yêu cầu header, tham số hoặc xác thực khác nhau, vì vậy ví dụ chạy được với GitHub không thay thế tài liệu của API bạn đang dùng.
Khi viết code, kiểm tra cả mã trạng thái và nội dung response. 200 thường là thành công; 401 thường liên quan xác thực; 404 là tài nguyên không tồn tại hoặc không được thấy; 429 là vượt giới hạn tần suất. Ý nghĩa chi tiết vẫn do từng API quy định.
Cách đọc tài liệu API lần đầu
- Tìm base URL, endpoint, phương thức HTTP và tham số bắt buộc.
- Xem API có cần tài khoản, token hay API key và hạn mức gọi hay không.
- Thử một request chỉ đọc với dữ liệu không nhạy cảm.
- Lưu một response mẫu đã xóa token để biết cấu trúc dữ liệu.
- Thử chủ động một trường hợp lỗi, chẳng hạn repository không tồn tại, rồi xem code xử lý ra sao.

API key và chi phí cần hiểu thế nào?
API không mặc định miễn phí hoặc trả phí. Một dịch vụ có thể cho dùng không cần key, có hạn mức miễn phí, yêu cầu thẻ, hoặc tính tiền theo lượt gọi. Đọc trang giá và điều khoản của chính dịch vụ trước khi thử. Không đặt key trong code sẽ đẩy lên Git; dùng biến môi trường và thêm file chứa bí mật vào .gitignore. Nếu key đã lộ, xóa khỏi file là chưa đủ: hãy thu hồi hoặc xoay key tại nhà cung cấp.
Bạn chưa cần hiểu sâu backend để gọi API chỉ đọc. Nhưng cần nắm request, response, trạng thái lỗi và dữ liệu đầu vào trước khi dùng API để sửa hoặc xóa dữ liệu.
Tài liệu đọc thêm: GitHub REST API và hướng dẫn bảo vệ bí mật trong repository.
API trong đời thường
API là lối giao tiếp có quy ước giữa chương trình. Ứng dụng thời tiết trên điện thoại không “vào phòng máy chủ” thủ công — nó gọi API và nhận dữ liệu theo định dạng (thường JSON).
Người mới cần biết: URL endpoint, phương thức (GET đọc, POST gửi), và rằng mọi API công khai đều có giới hạn/rate limit và điều khoản.
Thử API công khai an toàn
- Chọn API có tài liệu rõ, không đòi thông tin ngân hàng/CCCD.
- Dùng GET đơn giản trên trình duyệt hoặc
curl. - Đọc JSON bằng mắt trước khi viết code.
- Không dán API key lên GitHub — xem password manager và không commit secret.
JS có thể fetch sau khi bạn quen JavaScript cơ bản.






Để lại một bình luận