- Danh sách hướng dẫn kiểm tra API
- Tổng quan về hướng dẫn trong loạt bài kiểm tra API này
- Kết luận
- Hướng dẫn kiểm tra API
- Giới thiệu Thử nghiệm API trong tổ chức của bạn
Hướng dẫn kiểm tra API chuyên sâu này giải thích tất cả về kiểm tra API, dịch vụ web và cách giới thiệu kiểm tra API trong tổ chức của bạn:
Có được cái nhìn sâu sắc về Kiểm tra API cùng với khái niệm về thử nghiệm dịch chuyển trái và dịch vụ web từ hướng dẫn giới thiệu này.
Các khái niệm như API Web, cách API hoạt động (với ví dụ trong thế giới thực) và nó khác với Dịch vụ web như thế nào được giải thích rõ ràng bằng các ví dụ trong phần này hướng dẫn.
Danh sách hướng dẫn kiểm tra API
Hướng dẫn số 1: Hướng dẫn kiểm tra API: Hướng dẫn đầy đủ cho người mới bắt đầu
Hướng dẫn số 2: Hướng dẫn về dịch vụ web: Thành phần, Kiến trúc, Loại & Ví dụ
Hướng dẫn #3: 35 câu hỏi phỏng vấn API Web và ASP.Net hàng đầu kèm theo câu trả lời
Hướng dẫn #4: Hướng dẫn POSTMAN: Kiểm tra API Sử dụng POSTMAN
Hướng dẫn số 5: Kiểm tra dịch vụ web bằng ứng dụng khách HTTP Apache
Tổng quan về hướng dẫn trong loạt bài kiểm tra API này
Hướng dẫn # | Bạn sẽ học được gì | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Hướng dẫn_#1: | Hướng dẫn kiểm tra API : Hướng dẫn đầy đủ cho người mới bắt đầu Hướng dẫn kiểm tra API chuyên sâu này sẽ giải thích chi tiết tất cả về Kiểm tra API và Dịch vụ web, đồng thời hướng dẫn bạn cách Giới thiệu Kiểm tra API trong tổ chức của mình. | |||||||||||||||||||||||||||||||||||||||||||||
Hướng dẫn_#2: | Hướng dẫn về dịch vụ web: Thành phần, Kiến trúc, Loại & Ví dụ Web nàytính chính xác của các phản hồi từ API đối với phản hồi hợp lệ và không hợp lệ thực sự rất quan trọng. Nếu nhận được mã trạng thái 200 (có nghĩa là tất cả OK) dưới dạng phản hồi từ API thử nghiệm, nhưng nếu văn bản phản hồi cho biết đã gặp phải lỗi thì đây là lỗi. Ngoài ra, nếu thông báo lỗi chính nó là không chính xác, thì điều đó có thể gây hiểu nhầm cho khách hàng cuối đang cố gắng tích hợp với API này. Trong ảnh chụp màn hình bên dưới, người dùng đã nhập trọng lượng không hợp lệ, lớn hơn 2267 Kgs có thể chấp nhận được. API phản hồi với mã trạng thái lỗi và thông báo lỗi. Tuy nhiên, thông báo lỗi đề cập sai đơn vị trọng lượng là lbs thay vì KG. Đây là một lỗi có thể gây nhầm lẫn cho khách hàng cuối. (ii) Kiểm tra tải và hiệu suấtAPI được thiết kế để có thể mở rộng. Điều này làm cho Kiểm tra tải và hiệu suất trở nên cần thiết, đặc biệt nếu hệ thống được thiết kế dự kiến sẽ phục vụ hàng nghìn yêu cầu mỗi phút hoặc giờ, tùy thuộc vào yêu cầu. Thường xuyên thực hiện Kiểm tra tải và hiệu suất trên API có thể giúp đánh giá hiệu suất, tải cao nhất và điểm hỏng. Dữ liệu này hữu ích khi lập kế hoạch mở rộng quy mô ứng dụng. Có sẵn thông tin này sẽ giúp hỗ trợ các quyết định và lập kế hoạch, đặc biệt nếu tổ chức đang có kế hoạch thêm nhiều khách hàng hơn, điều đó có nghĩa là nhiều khách hàng sắp đến hơnyêu cầu. Cách giới thiệu thử nghiệm API trong tổ chức của bạnQuy trình giới thiệu thử nghiệm API trong bất kỳ tổ chức nào cũng tương tự như quy trình được sử dụng để triển khai hoặc triển khai bất kỳ công cụ và khuôn khổ thử nghiệm nào khác. Bảng bên dưới tóm tắt các bước chính cùng với kết quả dự kiến của từng bước.
Những thách thức thường gặp và cách để giảm thiểu chúngHãy để chúng tôi thảo luận về một số thách thức phổ biến mà các nhóm QA phải đối mặt khi cố gắng triển khai khung kiểm tra API trong một tổ chức. #1) Chọn đúng công cụChọn đúng công cụ cho công việc là thách thức phổ biến nhất. Có một số công cụ kiểm tra API có sẵn trên thị trường. Việc triển khai công cụ mới nhất, đắt nhất hiện có trên thị trường có vẻ rất hấp dẫn- nhưng nếu công cụ đó không mang lại kết quả mong muốn thì công cụ đó không có tác dụng. Do đó, hãy luôn chọn công cụ đáp ứng các yêu cầu 'phải có' dựa trên nhu cầu của tổ chức bạn. Dưới đây là ma trận đánh giá công cụ mẫu cho Công cụ API có sẵn
#2) Thiếu thông số kỹ thuật kiểm traLà người kiểm tra, chúng ta cần biết kết quả dự kiến để kiểm tra ứng dụng một cách hiệu quả. Đây thường là một thách thức, vì để biết được kết quả mong đợi, chúng tôi cần có các yêu cầu chính xác rõ ràng – điều này không xảy ra. Ví dụ , hãy xem xét các yêu cầu được cung cấp bên dưới: “Đơn đăng ký chỉ nên chấp nhận ngày giao hàng hợp lệ và tất cả các yêu cầu không hợp lệ sẽ bị từ chối” Những yêu cầu này thiếu các chi tiết chính và rất mơ hồ – chúng tôi xác định ngày hợp lệ như thế nào? Còn định dạng thì sao? Chúng tôi có trả lại bất kỳ thông báo từ chối nào cho người dùng cuối, v.v. không? Ví dụ về Yêu cầu rõ ràng: 1) Ứng dụng chỉ nên chấp nhận ngày giao hàng hợp lệ. Ngày giao hàng được coi là hợp lệ nếulà
2) Mã trạng thái phản hồi = 200 Thông báo: OK 3) Ngày vận chuyển không đáp ứng các tiêu chí trên nên được coi là không hợp lệ. Nếu khách hàng gửi ngày giao hàng không hợp lệ thì khách hàng phải phản hồi với (các) thông báo lỗi sau: 3.1 Mã trạng thái phản hồi NOT 200 Lỗi: Ngày vận chuyển được cung cấp không hợp lệ; vui lòng đảm bảo rằng ngày ở định dạng DD/MM/YYYY 3.2 Mã trạng thái phản hồi NOT 200 Lỗi: Ngày giao hàng được cung cấp ở quá khứ #3) Lộ trình học tậpNhư đã đề cập trước đây, phương pháp thử nghiệm API sẽ khác khi so sánh với phương pháp được áp dụng trong khi thử nghiệm các ứng dụng dựa trên GUI. Nếu bạn đang thuê các chuyên gia nội bộ hoặc chuyên gia tư vấn để kiểm tra API, thì thời gian học tập của phương pháp kiểm tra API hoặc công cụ kiểm tra API có thể là tối thiểu. Trong trường hợp này, bất kỳ lộ trình học tập nào cũng sẽ liên quan đến việc thu thập kiến thức về sản phẩm hoặc ứng dụng. Nếu một thành viên hiện tại trong nhóm được chỉ định học thử nghiệm API, thì tùy thuộc vào công cụ được chọn, lộ trình học tập có thể là trung bình đến cao, cùng với việc thay đổi phương pháp thử nghiệm. Đường cong học tập cho chính sản phẩm hoặc ứng dụng có thể ở mức trung bình thấp tùy thuộc vào việc người thử nghiệm này đã thử nghiệm hay chưaứng dụng đó trước đó hay không. #4) Bộ kỹ năng hiện cóĐiều này liên quan trực tiếp đến điểm trước đó về lộ trình học tập. Nếu người thử nghiệm đang chuyển đổi từ Thử nghiệm dựa trên GUI, thì người thử nghiệm sẽ cần thay đổi phương pháp thử nghiệm và tìm hiểu công cụ hoặc khung mới theo yêu cầu. Ví dụ: Nếu API chấp nhận yêu cầu ở định dạng JSON, thì người thử nghiệm sẽ cần tìm hiểu JSON là gì để bắt đầu tạo thử nghiệm. Nghiên cứu điển hìnhNhiệm vụ Để mở rộng quy mô ứng dụng hiện có, một công ty muốn cung cấp sản phẩm trong API cũng như ứng dụng GUI tiêu chuẩn. Nhóm QA được yêu cầu cung cấp Kế hoạch phạm vi thử nghiệm để đảm bảo rằng họ sẵn sàng đáp ứng thử nghiệm API ngoài các thử nghiệm dựa trên GUI thông thường. Thách thức
Phương pháp mà nhóm áp dụng để giảm thiểu rủi ro và giải quyết các thách thức
Kết luậnCác ứng dụng dựa trên API có nổi tiếng trong thời gian gần đây. Các ứng dụng này nhiều hơncó thể mở rộng so với các ứng dụng/phần mềm truyền thống và cho phép tích hợp dễ dàng hơn với các API hoặc ứng dụng khác. Hướng dẫn Kiểm tra API này giải thích chi tiết tất cả về Kiểm tra API, Kiểm tra Shift Left, Dịch vụ web và API Web. Chúng tôi cũng đã khám phá sự khác biệt giữa Dịch vụ web và API Web bằng các ví dụ. Trong phần thứ hai của hướng dẫn, chúng ta đã thảo luận về toàn bộ hoạt động Kiểm tra API, cách giới thiệu Kiểm tra API trong tổ chức của bạn và một số thách thức phổ biến trong quá trình này. quy trình này cùng với các giải pháp dành cho chúng. Hãy xem hướng dẫn sắp tới của chúng tôi để biết thêm về Dịch vụ web cùng với các ví dụ!! Hướng dẫn TIẾP THEO Hướng dẫn dịch vụ giải thích Kiến trúc, Loại & Các thành phần của Dịch vụ web cùng với các thuật ngữ quan trọng và sự khác biệt giữa SOAP và REST. | |||||||||||||||||||||||||||||||||||||||||||||
Hướng dẫn_#3: | 35 câu hỏi phỏng vấn ASP.Net và API Web hàng đầu có câu trả lời Bạn có thể khám phá danh sách các Câu hỏi phỏng vấn ASP.Net và Web API thường gặp nhất kèm theo câu trả lời & ví dụ dành cho người mới bắt đầu và các chuyên gia có kinh nghiệm trong hướng dẫn này. | |||||||||||||||||||||||||||||||||||||||||||||
Hướng dẫn_#4: | Hướng dẫn POSTMAN: Kiểm tra API bằng cách sử dụng POSTMAN Hướng dẫn từng bước này sẽ giải thích Kiểm tra API bằng POSTMAN cùng với Kiến thức cơ bản về POSTMAN, Thành phần của nó và Yêu cầu mẫu & Phản hồi bằng thuật ngữ đơn giản để bạn dễ hiểu. | |||||||||||||||||||||||||||||||||||||||||||||
Hướng dẫn_#5: | Kiểm tra dịch vụ web bằng ứng dụng khách HTTP Apache Hướng dẫn API này nói về việc thực hiện các Hoạt động CRUD khác nhau trên Dịch vụ web và Kiểm tra dịch vụ web bằng Máy khách HTTP Apache |
Hướng dẫn kiểm tra API
Phần này sẽ giúp bạn hiểu cơ bản về Dịch vụ web và API Web, từ đó sẽ hữu ích trong việc hiểu các khái niệm chính trong các hướng dẫn sắp tới trong loạt bài Kiểm tra API này.
API ( Giao diện lập trình ứng dụng) là một tập hợp tất cả các thủ tục và chức năng cho phép chúng tôi tạo một ứng dụng bằng cách truy cập dữ liệu hoặc tính năng củahệ điều hành hoặc nền tảng. Kiểm tra các quy trình như vậy được gọi là Kiểm tra API.
Kiểm tra Shift Left
Một trong những loại kiểm tra quan trọng hiện đang được hỏi trong các cuộc phỏng vấn Kiểm tra API là Kiểm tra Shift Left. Loại thử nghiệm này được thực hiện trong hầu hết tất cả các dự án tuân theo Phương pháp Agile.
Trước khi Thử nghiệm Shift Left được giới thiệu, thử nghiệm phần mềm chỉ được hình thành sau khi quá trình mã hóa hoàn tất và mã đã được gửi cho người thử nghiệm. Cách làm này dẫn đến việc phải hối hả vào phút cuối để kịp thời hạn và nó cũng cản trở rất nhiều đến chất lượng sản phẩm.
Bên cạnh đó, những nỗ lực (khi các lỗi được báo cáo ở giai đoạn cuối trước khi sản xuất) đã bị bỏ qua. rất lớn vì các nhà phát triển phải trải qua lại cả giai đoạn thiết kế và mã hóa.
Vòng đời phát triển phần mềm (SDLC) Trước khi thử nghiệm chuyển sang trái
Luồng SDLC truyền thống là: Yêu cầu – > Thiết kế –> Mã hóa –> Kiểm tra.
Nhược điểm của Kiểm tra truyền thống
- Kiểm tra là cực kỳ đúng đắn. Rất nhiều chi phí phát sinh khi một lỗi được xác định vào phút cuối.
- Thời gian tiêu tốn để giải quyết lỗi và kiểm tra lại lỗi đó trước khi đưa nó vào sản xuất.
Do đó, một ý tưởng mới xuất hiện để chuyển giai đoạn thử nghiệm sang trái, từ đó dẫn đến Thử nghiệm chuyển sang trái.
Đọc được đề xuất => Kiểm tra chuyển sang trái: ACâu thần chú bí mật để thành công trong phần mềm
Các giai đoạn của kiểm tra chuyển đổi bên trái
Kiểm tra chuyển đổi bên trái đã dẫn đến quá trình chuyển đổi thành công từ Phát hiện lỗi sang Phòng ngừa lỗi. Nó cũng giúp phần mềm nhanh chóng hết lỗi và khắc phục tất cả các lỗi sớm nhất.
API Web
Nói chung, API Web có thể được định nghĩa là thứ nhận yêu cầu từ khách hàng hệ thống tới máy chủ web và gửi lại phản hồi từ máy chủ web tới máy khách.
API hoạt động như thế nào?
Hãy lấy một tình huống rất phổ biến là đặt chuyến bay trên www.makemytrip.com, một dịch vụ du lịch trực tuyến tổng hợp thông tin từ nhiều hãng hàng không. Khi đặt vé máy bay, bạn nhập thông tin như ngày đi/ngày về, hạng, v.v. và nhấp vào tìm kiếm.
Thao tác này sẽ hiển thị cho bạn giá của nhiều hãng hàng không và tình trạng sẵn có của các hãng đó. Trong trường hợp này, ứng dụng tương tác với API của nhiều hãng hàng không và do đó cấp quyền truy cập vào dữ liệu của hãng hàng không.
Một ví dụ khác là www.trivago.com so sánh và liệt kê giá, tình trạng phòng trống, v.v. của các khách sạn khác nhau từ một thành phố cụ thể. Trang web này giao tiếp với API của nhiều khách sạn để truy cập cơ sở dữ liệu và liệt kê giá cũng như tình trạng phòng trống từ trang web của họ.
Do đó, API Web có thể được định nghĩa là “giao diện tạo điều kiện giao tiếp giữa máy khách và cácmáy chủ web”.
Dịch vụ web
Dịch vụ web là (như API Web) các dịch vụ phục vụ từ máy này sang máy khác. Nhưng điểm khác biệt chính phát sinh giữa API và Dịch vụ web là Dịch vụ web sử dụng mạng.
Có thể nói rằng tất cả Dịch vụ web đều là API web nhưng tất cả API web không phải là Dịch vụ web (được giải thích trong phần sau của bài viết). Do đó, Dịch vụ web là một tập hợp con của API Web. Tham khảo sơ đồ bên dưới để biết thêm về API Web và Dịch vụ web.
API Web so với Dịch vụ web
Dịch vụ web so với API Web
Cả Web API và Dịch vụ web đều được sử dụng để hỗ trợ giao tiếp giữa máy khách và máy chủ. Sự khác biệt chính chỉ đến từ cách họ giao tiếp.
Mỗi người trong số họ yêu cầu nội dung yêu cầu được chấp nhận bằng một ngôn ngữ cụ thể, sự khác biệt của họ trong việc cung cấp kết nối an toàn, tốc độ giao tiếp với máy chủ và phản hồi lại cho khách hàng, v.v.
Sự khác biệt giữa Dịch vụ web và API Web được liệt kê bên dưới để bạn tham khảo.
Dịch vụ web
- Dịch vụ web thường sử dụng XML (Ngôn ngữ đánh dấu mở rộng), có nghĩa là chúng an toàn hơn.
- Dịch vụ web an toàn hơn vì cả Dịch vụ web và API đều cung cấp SSL (Lớp cổng bảo mật) trong quá trình truyền dữ liệu , nhưng nó cũng cung cấp WSS (Bảo mật dịch vụ web).
- Dịch vụ web là một tập hợp con của API Web. Ví dụ: Dịch vụ web chỉ dựa trên ba kiểu sử dụng, tức là SOAP, REST và XML-RPC.
- Dịch vụ web luôn cần mạng để hoạt động.
- Dịch vụ web hỗ trợ “Các ứng dụng khác nhau trong One Code”. Điều này có nghĩa là một mã chung hơn được viết trên các ứng dụng khác nhau.
API Web
- API Web thường sử dụng JSON (Ký hiệu đối tượng JavaScript), điều đó có nghĩa là API Web nhanh hơn.
- API Web nhanh hơn vì JSON có trọng lượng nhẹ, không giống như XML.
- API Web là tập hợp cao nhất của Dịch vụ web. Ví dụ: Tất cả ba kiểu Dịch vụ web đều có trong API Web, nhưng ngoài ra, nó sử dụng các kiểu khác như JSON – RPC.
- API Web không nhất thiết phải yêu cầu mạng để vận hành.
- API Web có thể hỗ trợ hoặc không hỗ trợ khả năng tương tác tùy thuộc vào bản chất của hệ thống hoặc ứng dụng.
Giới thiệu Thử nghiệm API trong tổ chức của bạn
Trong cuộc sống hàng ngày, tất cả chúng ta đã quá quen với việc tương tác với các Ứng dụng bằng API nhưng chúng ta thậm chí không nghĩ đến các quy trình phụ trợ điều khiển chức năng cơ bản.
Ví dụ: , Giả sử bạn đang duyệt qua các sản phẩm trên Amazon.com và bạn thấy một sản phẩm/giao dịch mà bạn thực sự thích và bạn muốn chia sẻ nó với mạng Facebook của mình.
Ngay khi bạn nhấp vào trên biểu tượng Facebook trên phần chia sẻ của trang và nhập của bạnThông tin đăng nhập tài khoản Facebook để chia sẻ, bạn đang tương tác với một API đang kết nối liền mạch trang web Amazon với Facebook.
Trọng tâm Chuyển sang Kiểm tra API
Trước khi thảo luận thêm về kiểm tra API, hãy thảo luận về lý do mà các ứng dụng dựa trên API đã trở nên phổ biến trong thời gian gần đây.
Có một số lý do khiến các tổ chức đang chuyển đổi sang các sản phẩm và ứng dụng dựa trên API. Và một vài trong số chúng được liệt kê bên dưới để bạn tham khảo.
#1) Các ứng dụng dựa trên API có khả năng mở rộng hơn khi so sánh với các ứng dụng/phần mềm truyền thống. Tốc độ phát triển mã nhanh hơn và cùng một API có thể đáp ứng nhiều yêu cầu hơn mà không có bất kỳ thay đổi lớn nào về mã hoặc cơ sở hạ tầng.
#2) Các nhóm phát triển không cần phải bắt đầu viết mã từ đầu mọi lúc khi họ bắt đầu làm việc để phát triển một tính năng hoặc ứng dụng. Các API thường sử dụng lại các chức năng, thư viện, thủ tục được lưu trữ, v.v. hiện có, có thể lặp lại và do đó, quy trình này có thể giúp chúng hoạt động hiệu quả hơn về tổng thể.
Ví dụ: Nếu bạn là nhà phát triển đang làm việc trên một trang web thương mại điện tử và bạn muốn thêm Amazon làm bộ xử lý thanh toán – thì bạn không phải viết mã từ đầu.
Tất cả những gì bạn cần làm là thiết lập tích hợp giữa trang web của bạn và API Amazon bằng cách sử dụng Khóa tích hợp và gọi API Amazon để xử lý thanh toán trong quá trình thanh toán.
#3) API cho phéptích hợp dễ dàng với các hệ thống khác cho cả các ứng dụng độc lập được hỗ trợ cũng như với các sản phẩm phần mềm dựa trên API.
Ví dụ , Giả sử bạn muốn gửi một lô hàng từ Toronto đến New York . Bạn truy cập trực tuyến, điều hướng đến một trang web Freight hoặc Logistics nổi tiếng và nhập thông tin bắt buộc.
Sau khi cung cấp thông tin bắt buộc, khi bạn nhấp vào nút Get Rates – ở phía sau, trang web logistics này có thể đang kết nối với một số API và ứng dụng của nhà cung cấp dịch vụ và nhà cung cấp dịch vụ để có được tỷ lệ động cho tổ hợp vị trí từ điểm gốc đến điểm đến.
Toàn bộ phạm vi kiểm tra API
Việc kiểm tra API không bị hạn chế đối với việc gửi yêu cầu vào API và chỉ phân tích phản hồi về tính chính xác. Các API cần được kiểm tra hiệu suất của chúng dưới các mức tải khác nhau đối với các lỗ hổng.
Hãy thảo luận chi tiết về vấn đề này.
(i) Kiểm tra chức năng
Thử nghiệm chức năng có thể là một nhiệm vụ đầy thách thức do thiếu giao diện GUI.
Hãy xem cách tiếp cận thử nghiệm chức năng cho API khác với ứng dụng dựa trên GUI như thế nào và chúng ta cũng sẽ thảo luận về một số ví dụ về nó.
a) Sự khác biệt rõ ràng nhất là không có GUI để tương tác. Những người kiểm thử thường thực hiện kiểm thử chức năng dựa trên GUI cảm thấy khó hơn một chút khi chuyển sang kiểm thử ứng dụng không phải GUI khi so sánh vớingười đã quen thuộc với nó.
Ban đầu, ngay cả trước khi bắt đầu thử nghiệm API, bạn sẽ cần phải kiểm tra và xác minh chính quy trình Xác thực. Phương thức xác thực sẽ thay đổi từ API này sang API khác và sẽ liên quan đến một số loại khóa hoặc mã thông báo để xác thực.
Nếu bạn không thể kết nối thành công với API thì không thể tiến hành thử nghiệm thêm. Quá trình này có thể được coi là tương đương với xác thực người dùng trong các ứng dụng tiêu chuẩn mà bạn cần thông tin xác thực hợp lệ để đăng nhập và sử dụng ứng dụng.
b) Việc kiểm tra xác thực trường hoặc xác thực dữ liệu đầu vào là rất quan trọng trong quá trình thử nghiệm API. Nếu có giao diện dựa trên biểu mẫu (GUI) thực tế, thì việc xác thực trường có thể được triển khai ở giao diện người dùng hoặc giao diện người dùng, do đó đảm bảo rằng người dùng không được phép nhập các giá trị trường không hợp lệ.
Ví dụ: Nếu một ứng dụng cần định dạng ngày là DD/MM/YYYY, thì chúng tôi có thể áp dụng xác thực này trên biểu mẫu thu thập thông tin để đảm bảo rằng ứng dụng đang nhận và xử lý một ngày hợp lệ.
Tuy nhiên, điều này không giống với các ứng dụng API. Chúng tôi cần đảm bảo rằng API được viết tốt và có thể thực thi tất cả các quy trình xác thực này, phân biệt giữa dữ liệu hợp lệ và không hợp lệ, đồng thời trả lại mã trạng thái và thông báo lỗi xác thực cho người dùng cuối thông qua phản hồi.
c) Kiểm tra