AllianceProject Handbook
← Thuật ngữ

Kiến trúc và dữ liệu

API

viết đầy đủ là Application Programming Interface

còn gọi là giao diện lập trình

Hợp đồng cho phép hai phần mềm nói chuyện với nhau — bên gọi không cần biết bên kia làm thế nào.

API là hợp đồng, không phải mã. Nó nói: gửi cái này lên thì nhận về cái kia. Phần bên trong đổi thoải mái, miễn hợp đồng giữ nguyên.

Vì vậy đổi API là việc nặng: mọi bên đang gọi phải đổi theo. Trên mobile còn nặng hơn, vì bản cũ nằm trên máy người dùng và không ép cập nhật được — máy chủ phải chịu được cả bản cũ lẫn bản mới cùng lúc.

Hai thứ nên chốt sớm và ghi rõ: hình dạng dữ liệu trả về, và cách báo lỗi. Mỗi API báo lỗi một kiểu là nguồn lỗi bất tận ở phía app.

Bài dùng thuật ngữ này