Jan 12, 2022

API và các thuật ngữ quan trọng BA nên biết! - Phần 2

Để các bạn BA có thêm nhiều kiến thức về API, hôm nay BAC sẽ tiếp tục gửi đến các bạn bài viết về những thuật ngữ cực hữu ích đối với BA. Hãy theo dõi ngay nhé!

Nếu các bạn chưa xem qua phần 1, hãy xem ngay:

API và các thuật ngữ quan trọng BA nên biết! - Phần 1

1. HTTP Methods

HTTP Methods là các phương thức/hành động tương tác với resource. Một số phương thức phổ biến:

POST: Có nghĩa là tạo mới, tương ứng với . Ví dụ bạn muốn thêm một sản phẩm và trang web, bạn sẽ thêm những thông tin như: Tên, hình ảnh, giá cả, mô tả.
GET: Đây là phương thức rất phổ biến dùng để đọc hoặc truy xuất dữ liệu. Ví dụ khi cần truy xuất các bài viết từ Facebook, bạn sẽ sử dụng phương thức GET.

PUT: PUT dùng để thay thế hoặc cập nhật các thông tin của resource.
DELETE: DELETE giúp client xóa bỏ các thông tin.

Các phương thức rất quan trọng và ảnh hưởng lớn đến dữ liệu gốc nên khi sử dụng chúng ta cần cẩn trọng để tránh gây ra sai sót.

2. Endpoints

Tương tự khi cần đến nhà một người bạn chúng ta cần biết địa chỉ nhà của họ, khi truy xuất thông tin ta cũng cần biết “địa chỉ” của dữ liệu.

Ví dụ, để lấy thông tin của một album trên Spotify ta cần cú pháp GET v1/albums/{id}/tracks.

Trong đó:

HTTP Method: GET.
Endpoint: /v1/albums/{id}/tracks.
Mục đích: để lấy danh sách các track trong một album cụ thể. Có thể đưa thêm các tham số để giới hạn thông tin trả về.

3. API Documentation

Để các bên liên quan có thể hiểu các thông tin liên quan như quyền hạn, thông tin, cách sử dụng thì API Documentation chính là đảm nhiệm nhiệm vụ đó. Trong tài liệu API sẽ có đầy đủ các thông tin như:

Authentication Instructions: Trong đây sẽ hướng dẫn cách bạn kết nối với API. Ví dụ cụ thể Authentication Instructions của Twitter xem ngay TẠI ĐÂY.

API Endpoints: Là xem các “địa chỉ” tham chiếu hiện tại của API. Bạn có thể tham khảo thêm về các Endpoints của Twitter TẠI ĐÂY.

Resources: Các tài nguyên nào có sẵn và bạn có thể truy cập.
Request Format: Là định dạng quy định cho các yêu cầu.
Response Format:Là định dạng quy định cho các phản hồi
Response Codes: Các loại mã bao gồm thành công và tình huống lỗi. Chúng ta vẫn rất thường gặp 404 nhưng vẫn chưa biết chúng là gì, cùng xem chi tiết hơn ở phần dưới nhé!

4. API Calls

API calls là toàn bộ quá trình gửi request và nhận response. Để hiểu rõ hơn chúng ta cần thực hiện qua một số bước sau:

Tìm URI.
Xác định HTTP Methods.
Thêm vào Header (sẽ giải thích ở phần 7).
Thêm mã API hoặc mã truy cập.
Chờ đợi phản hồi.

5. Payload

Payload bao gồm các thông tin trong response tuy nhiên ở đây payload đề cập đến chủ yếu thông tin “quan trọng” mà khách hàng muốn nhận được. Ví dụ, trong một response sẽ bao gồm nhiều nội dung nhưng Welcome, world! chính là Payload.

Các bạn lập trình viên rất thường sử dụng thuật ngữ này, vậy nên là một BA, hãy thể hiện sự chuyên nghiệp của mình hiểu đúng và dùng đúng khi lập trình viên hoặc khách hàng đề cập nhé!

6. Response Codes

Khi truy cập trang web mà bị lỗi chúng ta thường thấy lỗi 404 error và có thắc mắc rằng đó là gì? Đó chính là Response Codes - phản hồi về trạng thái trạng web dưới hình thức mã.

Danh sách mã rất nhiều và đại diện từng đầu mã như sau:

Các mã bắt đầu bằng 1xx: Phản hồi thông tin - yêu cầu đã được nhận, tiếp tục quá trình.
Các mã bắt đầu bằng 2xx: Thành công - yêu cầu đã được nhận, hiểu và chấp nhận thành công chuyển hướng.
Các mã bắt đầu bằng 3xx: Chuyển hướng - Cần thực hiện thêm hành động để hoàn thành yêu cầu.
Các mã bắt đầu bằng 4xx: Lỗi máy khách - Yêu cầu chứa cú pháp sai hoặc không thể đáp ứng.
Các mã bắt đầu bằng 5xx: Lỗi máy chủ - Máy chủ không thực hiện được yêu cầu mặc dù hợp lệ.

7. Headers

API Headers là nguồn thông tin bổ sung cho mỗi API Call. Chúng ta có thể xem thêm hình minh họa để hiểu chính xác hơn về headers.

Một số thông tin trong headers mà chúng ta thường gặp là:

Authorisation: Phần này dùng để xác thực cho phép Client truy cập vào Server.
Content-type: Xác định kiểu representation. Trong hình minh họa chúng ta có thể thấy là JSON.
Date: Là thời gian của request, response.

8. Authentication

Mặc dù là mã nguồn mở nhưng API vẫn cần độ bảo mật và an toàn nhất định, vậy nên việc xác thực người dùng là rất quan trọng. Ở đây có hai thuật ngữ cần phân biệt là Authentication và Authorisation:

Authentication: Là xác định Client là ai, có đúng những người mà Server cấp phép hay không. Thường trong API sẽ dùng các Key và Token để xác thực Client. Bạn có thể tham khảo ví dụ hình minh họa.

Authorisation: Sau khi xác minh đúng Client rồi thì cũng cần xác thực thêm thông tin về quyền hạn của Client để cung cấp cho chính xác các thông tin.

9. Polling vs. Webhook

Polling và Webhook có chức năng cơ bản là tương đồng nhau là cập nhật các thông tin mới. Tuy nhiên khác nhau ở một điểm:

Polling là Client chủ động liên hệ với phía Server để cập nhật các thông tin mới. Sau đó Server sẽ phản hồi lại cho Client.
Webhook là Server tự cập nhật dữ liệu ngay khi có những thay đổi.

Nguồn tham khảo:

Bài viết API 101 - tác giả Thai Son

Nhu cầu đào tạo doanh nghiệp

BAC là đơn vị đào tạo BA đầu tiên tại Việt Nam. Đối tác chính thức của IIBA quốc tế. Ngoài các khóa học public, BAC còn có các khóa học in house dành riêng cho từng doanh nghiệp. Chương trình được thiết kế riêng theo yêu cầu của doanh nghiệp, giúp doanh nghiệp giải quyết những khó khăn và tư vấn phát triển.

CÁC KHOÁ HỌC BUSINESS ANALYST BACs.VN DÀNH CHO BẠN

Khoá học Online:

Khoá học Offline:

Tại Tp.HCM:

Tại Hà Nội:

Tham khảo lịch khai giảng TẤT CẢ các khóa học mới nhất

Ban biên tập nội dung - BAC

Click để đọc tiếp

Mục đích chính của phân tích dữ liệu là gì? Ứng dụng thực tế trong công việc

Mục đích chính của phân tích dữ liệu là gì và làm thế nào để ứng dụng trong công việc là những câu hỏi thường gặp. BAC sẽ giúp bạn tổng hợp những kiến thức nền tảng thông qua các ví dụ thực tế, gần gũi.
Bài tập phân tích dữ liệu trong kinh doanh cho người mới bắt đầu có đáp án

Bạn muốn tìm bài tập phân tích dữ liệu trong kinh doanh cho người mới bắt đầu có đáp án? Bạn là người mới và chưa biết phải bắt đầu từ đâu? Hãy để BAC giúp bạn thông qua hướng dẫn chi tiết ở đây.
Dữ liệu thứ cấp là gì? phương pháp phân tích dữ liệu thứ cấp là gì?

Nếu bạn đang tìm hiểu về phân tích dữ liệu và gặp khái niệm dữ liệu thứ cấp thì đây là bài viết dành cho bạn. BAC sẽ giúp bạn tìm hiểu tất cả thông tin như định nghĩa, đặc điểm, ưu và nhược điểm cũng như những phương pháp phân tích.
Business Analyst thời đại AI: Cơ hội, thách thức và kỹ năng cần có để không bị thay thế

Trí tuệ nhân tạo (AI) đang thay đổi ngành phát triển phần mềm, ảnh hưởng đến vai trò của Business Analyst (BA). Hãy phân tích BA cần làm gì để thích nghi ở thời đại mới

Bình luận

Lê Anh Tuấn

Chuyên viên HO - Kỹ thuật Ngân hàng số Eximbank

Tôi là nhân sự thuộc Trung tâm Phát triển CNTT – Khối Ngân hàng số, hiện đang đảm nhiệm vai trò kiểm thử phần mềm (tester). Việc tham gia khóa học Business Analyst đã mang lại cho tôi góc nhìn toàn diện và rõ ràng hơn về vai trò của BA trong lĩnh vực ngân hàng.

Khóa học Fundamental Business Analysis tại BAC không chỉ giúp tôi hiểu đúng bản chất công việc BA mà còn hỗ trợ phát triển tư duy nghiệp vụ – từ tiếp cận giải pháp kỹ thuật sang tập trung vào nhu cầu người dùng. Phương pháp giảng dạy kết hợp lý thuyết và thực hành thực tiễn, cùng các hoạt động mô phỏng, thảo luận nhóm đã giúp tôi nâng cao kỹ năng giao tiếp, phân tích và trình bày yêu cầu – những năng lực thiết yếu để phối hợp hiệu quả giữa các bên trong dự án công nghệ.

Xem chi tiết +
Huỳnh Cao Cường

Nhân viên HO - Kỹ thuật Ngân hàng số Eximbank

Tôi hiện đang công tác tại Trung tâm Phát triển CNTT – Khối CNTT, với vai trò là nhân sự chức năng phụ trách mảng Ngân hàng số, chuyên sâu về kiểm thử phần mềm (Tester). Trước khi tham gia khóa học Fundamental Business Analysis do BAC tổ chức, tôi từng hình dung BA chỉ đơn thuần là cầu nối giữa bộ phận kỹ thuật và nghiệp vụ.

Tuy nhiên, quá trình học đã giúp tôi nhận thức rõ hơn về bản chất và tầm quan trọng của vị trí này. BA không chỉ kết nối các bên liên quan, mà còn giữ vai trò định hình yêu cầu, đảm bảo giải pháp được thiết kế đúng mục tiêu và sát với nhu cầu thực tế. Khóa học đã trang bị cho tôi tư duy phân tích bài bản, khả năng diễn đạt yêu cầu rõ ràng, và kỹ năng phối hợp hiệu quả trong môi trường dự án đa chiều.

Với nền tảng công nghệ thông tin sẵn có, khóa học là bước chuyển hướng quan trọng giúp tôi phát triển tư duy nghiệp vụ vững chắc và sẵn sàng theo đuổi lộ trình nghề nghiệp chuyên sâu trong lĩnh vực Business Analysis tại Eximbank.

Xem chi tiết +
Nguyễn Thị Mai Bình

Business Analyst

Với một người ngoại đạo như mình thì những chuyên đề về "kỹ thuật" của BA hết sức quan trọng. Ví dụ như sử dụng các diagram để mô hình hóa requirement, viết User Story/Use case, v...v..

Đến với khóa học Fundamental Business Analysis, mình đã được gặp thầy Lộc, một người người rất nhiệt tình và có tâm. Ngoài việc chia sẻ các kinh nghiệm thực tế trên lớp thì thầy còn dành thời gian ra để tư vấn, hỗ trợ, góp ý CV cho mình. Bên cạnh đó trung tâm và anh Phụng cũng hỗ trợ gửi CV, kết nối học viên tới mạng lưới các công ty đối tác chất lượng, điều này giúp học viên như mình tìm được công việc phù hợp nhất. Cảm ơn BAC.
Xem chi tiết +

Professional Transfer Services in Batumi

Luxury Georgian Transfer Services – Tbilisi & Batumi

Airport Transfers in Georgia

Mục đích chính của phân tích dữ liệu là gì? Ứng dụng thực tế trong công việc

Bài tập phân tích dữ liệu trong kinh doanh cho người mới bắt đầu có đáp án

Dữ liệu thứ cấp là gì? phương pháp phân tích dữ liệu thứ cấp là gì?

Business Analyst thời đại AI: Cơ hội, thách thức và kỹ năng cần có để không bị thay thế

CÔNG TY CỔ PHẦN ĐÀO TẠO VÀ TƯ VẤN BAC