API Protocol
Định nghĩa
API protocol là tập quy tắc định nghĩa cách các hệ thống gửi request, format response, xử lý lỗi, bảo mật và trao đổi dữ liệu qua mạng.
Cách hiểu bằng lời của tôi
Chọn protocol là chọn trade-off vận hành: REST dễ dùng và cache tốt, GraphQL linh hoạt cho frontend, gRPC hiệu quả cho service nội bộ, WebSocket/SSE xử lý realtime, Webhook phù hợp event server-to-server.
Câu hỏi chọn protocol
- Dữ liệu là CRUD resource hay workflow/event stream?
- Client là browser/public developer hay service nội bộ?
- Có cần realtime một chiều hay hai chiều?
- Cần strict schema/codegen hay human-readable JSON?
- Caching HTTP có quan trọng không?
- Security model và tooling team đã quen tới đâu?