Nếu bạn làm việc với các dịch vụ gRPC, bạn có lẽ đã gặp phải giới hạn của các công cụ API thông thường. Nhiều client coi gRPC là một phần bổ sung không quan trọng. Kreya đi theo một hướng ngược lại. Nó đặt gRPC làm trung tâm và xây dựng phần còn lại của các giao thức xung quanh nó.
Hướng dẫn này giải thích Kreya là gì, nó hoạt động tốt như thế nào, cách nó lưu trữ công việc của bạn và phù hợp với ai. Đến cuối bài, bạn sẽ biết liệu nó có phù hợp với quy trình làm việc của mình hay không.
Một lưu ý nhanh trước khi chúng ta bắt đầu. Bài viết này nói về Kreya, một client API được tạo bởi riok GmbH và có tại kreya.app. Nó không phải là thương hiệu thời trang hoặc làm đẹp cùng tên. Nếu bạn đến đây để tìm quần áo, bạn đã nhầm chỗ.
Kreya là gì?
Kreya là một client API GUI dành cho máy tính để bàn, được xây dựng bởi riok GmbH, một công ty phần mềm có trụ sở tại Thụy Sĩ. Nó cung cấp cho bạn một giao diện đồ họa để gọi và kiểm thử API trên nhiều giao thức khác nhau.
Nó hỗ trợ gRPC, REST, GraphQL, WebSocket và Server-Sent Events. Điều này bao gồm hầu hết những gì một nhà phát triển backend hiện đại làm việc trong một ngày. Bạn cài đặt nó một lần và có thể gọi bất kỳ giao thức nào trong số đó từ một cửa sổ duy nhất.
Kreya là phần mềm độc quyền với mô hình freemium. Client cốt lõi được sử dụng miễn phí. Các gói trả phí bổ sung các tính năng nâng cao cho cá nhân và nhóm. Chúng tôi sẽ đề cập đến cấu trúc giá sau.
Sản phẩm chạy như một ứng dụng máy tính để bàn gốc trên macOS, Windows và Linux. Không có phiên bản trình duyệt và không yêu cầu tài khoản đám mây. Bạn tải xuống, cài đặt và bắt đầu gọi API.
Định vị gRPC là ưu tiên hàng đầu
Hầu hết các client API ban đầu là các công cụ REST. Họ đã bổ sung gRPC sau này, thường chỉ là một lớp mỏng. Kreya đảo ngược thứ tự đó. Hỗ trợ gRPC của nó rất sâu rộng, chứ không phải được gắn thêm.
Bạn có thể tải một dịch vụ theo hai cách. Nhập trực tiếp tệp .proto, hoặc sử dụng phản chiếu máy chủ gRPC để lấy định nghĩa dịch vụ từ một máy chủ đang chạy. Phản chiếu có nghĩa là bạn không phải lúc nào cũng cần có sẵn các tệp proto. Nếu máy chủ hiển thị chúng, Kreya sẽ đọc chúng cho bạn.
Nó xử lý mọi loại gọi gRPC. Điều đó bao gồm các yêu cầu unary, client-streaming, server-streaming và streaming hai chiều (duplex). Nhiều công cụ chỉ dừng lại ở các gọi unary. Kreya bao gồm đầy đủ các loại, điều này quan trọng khi bạn xây dựng các dịch vụ streaming thực tế.
Bên dưới, nó giao tiếp bằng HTTP/2, giao thức truyền tải mà gRPC phụ thuộc vào. Nó cũng hỗ trợ HTTP/1.1 và HTTP/3. Nếu bạn muốn tìm hiểu kỹ hơn về giao thức này, hãy xem hướng dẫn client gRPC của chúng tôi và bài viết hướng dẫn cách kiểm thử API gRPC.
Hỗ trợ Đa Giao thức
gRPC là điểm nhấn chính, nhưng Kreya không phải là một công cụ đơn giao thức. Nó xử lý các giao thức phổ biến mà bạn cần trong quá trình phát triển thông thường.
Đối với REST, bạn tạo yêu cầu với các phương thức, tiêu đề, tham số truy vấn và phần thân, sau đó kiểm tra phản hồi. Đây là những kiến thức cơ bản nhất trong công việc API. Tổng quan của chúng tôi về các client API REST sẽ giải thích loại này nếu bạn mới bắt đầu.
Đối với GraphQL, bạn gửi các truy vấn và thao tác chống lại một endpoint GraphQL và đọc phản hồi có cấu trúc. Nếu GraphQL là giao thức chính của bạn, bài tổng hợp của chúng tôi về các client GraphQL tốt nhất sẽ cung cấp cho bạn một cái nhìn tổng quan rộng hơn.
Đối với công việc thời gian thực, Kreya hỗ trợ WebSocket và Server-Sent Events. WebSocket cung cấp cho bạn một kênh hai chiều. SSE cung cấp cho bạn một luồng một chiều từ máy chủ đến client. Cả hai đều hữu ích khi bạn kiểm thử các luồng dữ liệu trực tiếp hoặc các dịch vụ kiểu trò chuyện.
Nếu bạn từng tự hỏi nên chọn giao thức nào cho một công việc cụ thể, bài phân tích của chúng tôi về REST so với GraphQL so với gRPC sẽ trình bày các ưu và nhược điểm.
Lưu trữ ngoại tuyến, ưu tiên quyền riêng tư và có thể so sánh bằng Git
Ba lựa chọn thiết kế đã khiến Kreya khác biệt so với các công cụ ưu tiên đám mây. Chúng có xu hướng quan trọng nhất đối với các nhóm có quy định dữ liệu nghiêm ngặt.
Chạy hoàn toàn ngoại tuyến
Kreya chạy trên máy tính của bạn mà không cần kết nối internet. Các yêu cầu, môi trường và phản hồi của bạn được giữ cục bộ. Bạn không cần đăng nhập vào dịch vụ đám mây để gửi yêu cầu. Đối với các nhà phát triển làm việc đằng sau tường lửa hoặc trên các hệ thống nhạy cảm, đây là một lợi thế thực sự. Xem hướng dẫn của chúng tôi về các lựa chọn client API ngoại tuyến tốt nhất để biết thêm về danh mục này.
Mặc định ưu tiên quyền riêng tư
Vì mọi thứ đều nằm trên thiết bị của bạn, dữ liệu API của bạn mặc định không bao giờ nằm ngoài tầm kiểm soát của bạn. Không có hệ thống đo từ xa nào kéo phần thân yêu cầu về máy chủ của nhà cung cấp. Kreya tự quảng bá là ưu tiên quyền riêng tư, và thiết kế mặc định ngoại tuyến đã chứng minh điều đó. Giấy phép Enterprise ngoại tuyến có thể loại bỏ hoàn toàn yêu cầu tài khoản đối với các môi trường bị khóa chặt.
Lưu trữ dự án có thể so sánh bằng Git
Đây là tính năng chinh phục các đội kỹ thuật. Kreya lưu trữ mỗi dự án dưới dạng các tệp JSON có cấu trúc, đơn giản trên đĩa. Các tệp đó có thể so sánh bằng Git, vì vậy bạn có thể commit chúng vào kho lưu trữ của mình như bất kỳ mã nào khác.
Lợi ích là kiểm soát phiên bản thực sự. Bạn xem xét các thay đổi API trong các pull request. Bạn thấy chính xác những gì một đồng đội đã thay đổi trong một yêu cầu. Bạn có thể hoàn tác một chỉnh sửa tồi bằng git revert. Không có định dạng đồng bộ hóa độc quyền nào nằm giữa bạn và lịch sử của bạn.
Điều này đặt Kreya vào cùng nhóm với các client API gốc Git khác. Nếu nhóm của bạn đã sử dụng Git, các định nghĩa API của bạn cũng sẽ nằm ở đó.
Kiểm thử và Tự động hóa
Kreya không chỉ là một công cụ khám phá. Nó còn giúp bạn xác minh rằng API của mình hoạt động chính xác theo thời gian.
Nó hỗ trợ các bài kiểm thử tự động. Bạn viết các bài kiểm thử dạng script bằng JavaScript để khẳng định các phản hồi. Bạn có thể chạy các bài kiểm thử dựa trên dữ liệu lặp qua một tập hợp các đầu vào. Điều này biến các kiểm tra đặc biệt thành các bộ kiểm thử có thể lặp lại.
Nó cũng cung cấp kiểm thử snapshot. Một snapshot ghi lại phản hồi cơ sở. Trong lần chạy tiếp theo, Kreya so sánh phản hồi trực tiếp với cơ sở đó và gắn cờ mọi sự sai lệch. Điều này giúp phát hiện các thay đổi ngẫu nhiên đối với hợp đồng API của bạn trước khi chúng đến môi trường sản xuất.
Đối với tích hợp liên tục, Kreya cung cấp tự động hóa CLI với báo cáo kiểu JUnit. Bạn chạy các bài kiểm thử đã lưu trong một pipeline và đưa kết quả vào bảng điều khiển CI của mình. Điều đó kết nối chặt chẽ giữa kiểm thử cục bộ và hệ thống xây dựng của bạn.
Mô hình Freemium
Kreya sử dụng mô hình định giá freemium với ba cấp độ. Số tiền chính xác có thể thay đổi, vì vậy hãy kiểm tra trang giá chính thức của Kreya trước khi bạn cam kết.
Gói Miễn phí là miễn phí vĩnh viễn. Nó bao gồm các giao thức cốt lõi: gRPC, REST, GraphQL, WebSocket và các phương pháp xác thực cơ bản. Đối với việc khám phá cá nhân và công việc yêu cầu hàng ngày, gói miễn phí có thể đáp ứng tốt.
Gói Pro hướng đến các cá nhân. Nó bổ sung các tính năng nâng cao: lập trình script, kiểm thử snapshot, bộ sưu tập, lịch sử yêu cầu và hỗ trợ qua email. Nếu bạn phụ thuộc vào kiểm thử tự động, đây là cấp độ bạn sẽ cần.
Gói Enterprise hướng đến các công ty. Nó bổ sung hỗ trợ ưu tiên, cổng thông tin khách hàng, giá cố định cho người dùng không giới hạn và tùy chọn giấy phép ngoại tuyến cho các môi trường không thể sử dụng tài khoản.
Các gói trả phí thường cung cấp bản dùng thử ngắn hạn để bạn có thể kiểm tra các tính năng nâng cao trước khi mua.
Kreya phù hợp với ai
Kreya phù hợp với một hồ sơ rõ ràng. Đây là một lựa chọn mạnh mẽ nếu bạn phù hợp với một hoặc nhiều tiêu chí sau:
- Các nhà phát triển chuyên sâu về gRPC. Nếu backend của bạn chạy trên gRPC, hỗ trợ phản chiếu của Kreya và khả năng streaming đầy đủ sẽ khiến nó trở thành một lựa chọn tự nhiên.
- Các nhóm ưu tiên quyền riêng tư. Nếu dữ liệu của bạn không thể rời khỏi máy tính của bạn, thiết kế ngoại tuyến, ưu tiên cục bộ sẽ giải quyết một vấn đề thực sự.
- Các nhóm tập trung vào Git. Nếu bạn muốn các định nghĩa API được xem xét trong các pull request, tính năng lưu trữ có thể so sánh bằng Git sẽ phù hợp với quy trình làm việc của bạn mà không gây trở ngại.
- Các cửa hàng đa giao thức. Nếu trong một ngày bạn phải làm việc với gRPC, REST và luồng WebSocket, một công cụ xử lý cả ba sẽ giúp bạn tiết kiệm thời gian chuyển đổi ngữ cảnh.
Nó sẽ ít phù hợp hơn nếu bạn cần một không gian làm việc dựa trên trình duyệt, được lưu trữ, hoặc nếu toàn bộ nhóm của bạn làm việc trên Mac, Windows và web và muốn một tài liệu đám mây được chia sẻ. Kreya được thiết kế ưu tiên cho máy tính để bàn.
Apidog phù hợp ở đâu
Kreya là một client API tập trung, ưu tiên quyền riêng tư với chiều sâu gRPC thực sự. Nếu nhu cầu của bạn chỉ dừng lại ở việc gọi và kiểm thử API từ một công cụ máy tính để bàn cục bộ, nó sẽ thực hiện tốt công việc đó.
Tuy nhiên, một số nhóm muốn nhiều hơn một client. Họ muốn thiết kế API, mô phỏng nó trước khi backend tồn tại, ghi lại tài liệu cho người dùng và cộng tác trong thời gian thực. Đó là một phạm vi khác.
Apidog là một nền tảng API tất cả trong một được xây dựng cho phạm vi rộng hơn đó. Giống như Kreya, nó xử lý gRPC, REST, GraphQL và WebSocket (cộng với SOAP và Socket.IO). Ngoài client, nó bổ sung trình thiết kế OpenAPI trực quan, các kịch bản kiểm thử tự động với CI/CD thông qua Apidog CLI, mô phỏng thông minh, tài liệu tương tác tự động tạo và không gian làm việc nhóm được chia sẻ. Nó được cung cấp dưới dạng ứng dụng máy tính để bàn cho Windows, Mac và Linux, cộng với một ứng dụng web và CLI.
Sự đánh đổi trung thực: Kreya gọn nhẹ hơn và mặc định ưu tiên ngoại tuyến, điều mà một số nhóm ưa thích. Apidog bao gồm toàn bộ vòng đời API ở một nơi khi bạn cần thiết kế, mô phỏng, tài liệu và cộng tác cùng với client. Nếu bạn đang cân nhắc các lựa chọn, bài tổng hợp của chúng tôi về các lựa chọn thay thế Postman và danh sách các client API tuyệt vời rộng hơn sẽ đặt cả hai vào đúng ngữ cảnh.
Câu hỏi thường gặp
Kreya có miễn phí không?
Có. Kreya có gói miễn phí vĩnh viễn bao gồm gRPC, REST, GraphQL, WebSocket và xác thực cơ bản. Các gói trả phí Pro và Enterprise bổ sung tính năng lập trình script, kiểm thử snapshot và hỗ trợ nhóm.
Kreya có phải là mã nguồn mở không?
Không. Kreya là phần mềm độc quyền do riok GmbH sản xuất. Gói miễn phí giúp nó dễ tiếp cận, nhưng mã nguồn không mở. Nếu mã nguồn mở quan trọng đối với bạn, hãy tìm các lựa chọn client API miễn phí cũng có mã nguồn mở.
Kreya có hoạt động ngoại tuyến không?
Có. Kreya là một ứng dụng máy tính để bàn chạy hoàn toàn ngoại tuyến. Các dự án, môi trường và phản hồi của bạn vẫn nằm trên máy của bạn. Không yêu cầu tài khoản đám mây để gửi yêu cầu.
Kreya hỗ trợ những giao thức nào?
Kreya hỗ trợ gRPC, REST, GraphQL, WebSocket và Server-Sent Events. Hỗ trợ gRPC của nó là sâu nhất, với nhập proto, phản chiếu máy chủ và tất cả bốn loại cuộc gọi streaming.
Kreya xử lý kiểm soát phiên bản như thế nào?
Kreya lưu trữ mỗi dự án dưới dạng các tệp JSON có thể so sánh bằng Git trên đĩa. Bạn commit chúng vào kho lưu trữ của mình, xem xét các thay đổi trong các pull request và hoàn tác các chỉnh sửa bằng các lệnh Git tiêu chuẩn.
Client API Kreya có liên quan đến thương hiệu thời trang Kreya không?
Không. Kreya được đề cập ở đây là client API tại kreya.app, do riok GmbH sản xuất. Nó không có mối liên hệ nào với bất kỳ thương hiệu thời trang hoặc làm đẹp nào cùng tên.