Cách tiếp cận API-first đang định hình tương lai của Zonos

Tiếp cận API-first là gì? 

Tiếp cận API-first tương phản rõ rệt với tiếp cận code-first, trong đó một nhóm bắt đầu bằng cách thiết kế chức năng của ứng dụng, viết code, và sau đó thêm API vào cuối quá trình.

Tại Zonos, xây dựng phần mềm bằng cách sử dụng tiếp cận API-first có nghĩa là thiết kế các giải pháp xung quanh một API, chứ không phải viết code cho một ứng dụng và thêm API sau này. Điều này có nghĩa là các API của chúng ta là tối quan trọng và là các sản phẩm trong chính nó; chúng ta thiết kế chúng với sự tập trung chặt chẽ vào nhu cầu của khách hàng, và chúng ta làm sáng tỏ các tài liệu và kiến trúc trước khi viết bất kỳ code nào.

Những lợi ích của tiếp cận API-first 

Tiếp cận API-first giúp thiết lập những tâm thế sau:

• Chúng ta hiểu rằng các API của chúng ta là giao diện chính cho khách hàng, và do đó xem chúng như những sản phẩm công khai của chúng ta.
• Tài liệu hóa trước khi viết code cho chúng ta cơ hội để suy luận, thảo luận, tinh chỉnh và giao tiếp các mục tiêu của chúng ta với các nhóm và các bên liên quan để tạo ra một sản phẩm cuối cùng tốt hơn.
• Khi chúng ta tập trung vào nhu cầu của khách hàng, chúng ta hiểu cách tốt nhất để thiết kế các API đáp ứng những nhu cầu đó.

Tâm thế này đặt các API và khách hàng lên hàng đầu và là rất quan trọng để thiết lập một nền tảng nơi mọi người tại Zonos chịu trách nhiệm cho sự thành công của khách hàng.

Các nhóm phát triển có thể làm việc song song

Tiếp cận API-first liên quan đến việc thiết lập một hợp đồng. Tạo ra một hợp đồng giữa các dịch vụ được các nhóm trong tổ chức tuân theo cho phép các nhóm đó làm việc trên nhiều API cùng một lúc. Các nhà phát triển không phải chờ các bản cập nhật API được phát hành trước khi chuyển sang API tiếp theo. Các nhóm có thể đồng thời kiểm tra các API và phụ thuộc API dựa trên các định nghĩa API được thiết lập trước.

Giảm chi phí phát triển

Các API và code có thể được tái sử dụng trên nhiều dự án khác nhau. Theo tiếp cận API-first, nếu một nhóm phát triển muốn xây dựng một ứng dụng mới, họ không phải bắt đầu từ đầu, tiết kiệm thời gian và tiền bạc. Thiết kế API-first cũng cho phép hầu hết các vấn đề được giải quyết trước khi bất kỳ code nào được viết, điều này giúp ngăn chặn các vấn đề khi đến lúc tích hợp các API với các ứng dụng.

Tăng tốc độ ra thị trường

Hầu hết quá trình xây dựng các API có thể được tự động hóa bằng cách sử dụng các công cụ để nhập các tệp định nghĩa API. Chúng ta bắt đầu bằng cách tạo các loại cốt lõi, định nghĩa và lược đồ; với các tệp đó, các công cụ API như tài liệu API, bộ phát triển phần mềm (SDK) và API giả có thể được tự động tạo. Tự động hóa đáng kể tăng tốc độ phát triển của các API và ứng dụng.

API-first cũng giúp có thể thêm các dịch vụ và công nghệ mới vào các ứng dụng mà không cần phải tái kiến trúc toàn bộ hệ thống. Zonos phải vận chuyển các tính năng vào sản xuất một cách nhanh chóng để duy trì khả năng cạnh tranh trên thị trường SaaS xuyên biên giới không ngừng thay đổi. Dễ dàng hơn để loại bỏ nợ kỹ thuật trong code cốt lõi hơn là di chuyển khách hàng từ một API được thiết kế kém.

Đảm bảo trải nghiệm nhà phát triển tốt

Người tiêu dùng API thường là các nhà phát triển, và trải nghiệm nhà phát triển (DX) có thể làm hoặc phá vỡ sự thành công của một API. Tiếp cận API-first đảm bảo rằng trải nghiệm nhà phát triển là tích cực vì một API được thiết kế tốt, tài liệu hóa tốt, nhất quán dễ dàng hơn để học và tái sử dụng. Điều này cũng tăng tốc độ thực hiện. Tất cả những lợi ích này đều có liên quan với nhau!

Tăng sự thành công lâu dài

Tiếp cận API-first cho phép tạo mẫu nhanh chóng và lặp lại, có nghĩa là chúng ta học nhanh chóng cái nào hoạt động và cái nào không. Giống như những lần thất bại 1.000 của Eddison trước khi tạo ra bóng đèn, API-first có nghĩa là chúng ta không thành công nhanh chóng và tiến tới với sự hiểu biết tốt hơn về cách đạt được thành công. API-first tăng sự thành công lâu dài của chúng ta bằng cách đảm bảo rằng các API đáng tin cậy, nhất quán và dễ dàng cho các nhà phát triển sử dụng.

Tại sao làm việc ngược lại hiệu quả? 

Vào năm 2015, tôi có cơ hội thiết kế lại trang thương mại điện tử của một thương hiệu tiêu dùng nổi tiếng. Tôi đánh giá các chỉ số hiệu suất chính (KPI) khác nhau liên quan đến hệ thống hiện có, và rõ ràng là những cải thiện tốt nhất có thể được thực hiện ở đâu:

• Tỷ lệ chuyển đổi trên máy tính để bàn thấp hơn tiêu chuẩn.
• Tỷ lệ chuyển đổi trên thiết bị di động là tồi tệ.
• Tỷ lệ lưu lượng truy cập di động đang tăng nhanh chóng và sẽ vượt quá 50% tổng lưu lượng truy cập trong vòng 12 tháng tiếp theo. Do tỷ lệ chuyển đổi trên thiết bị di động tồi tệ, hầu hết lưu lượng truy cập là di động không lý tưởng.

Với dữ liệu đó, điều gì sẽ tạo ra giá trị tối đa cho người dùng? Rõ ràng: khắc phục các vấn đề về trải nghiệm người dùng di động của trang web. Do đó, tôi đã sử dụng tiếp cận mobile-first để thiết kế lại trang web. Điều này có nghĩa là tất cả các thiết kế, kiến trúc, API, v.v. trước tiên xem xét trải nghiệm di động. Đó là ngược lại so với tiếp cận truyền thống vào thời điểm đó, trong đó tập trung vào trải nghiệm máy tính để bàn trước tiên, thường để lại trải nghiệm di động dưới dạng một việc bổ sung clumsily với tỷ lệ chuyển đổi kém. Tiếp cận mobile-first cũng đòi hỏi nhiều nỗ lực hơn trước — nó không phải là con đường dễ dàng. Một kiến trúc mới được yêu cầu, các API mới sẽ cần được viết, và nhiều thiết kế được yêu cầu cho mỗi breakpoint.

Tiếp cận mobile-first dẫn đến sự gia tăng đáng kể tỷ lệ chuyển đổi di động. Kiến trúc mới cũng mang lại những mức tăng ấn tượng trong tỷ lệ chuyển đổi trên máy tính để bàn. Tiếp cận này thành công vì nó xác định cách tạo ra giá trị người dùng tối đa và tập trung toàn bộ tiếp cận vào việc cung cấp giá trị đó. Nó tạo ra tâm thế đúng từ đầu. Tương tự — mặc dù nó có thể cảm thấy như làm việc ngược lại — tiếp cận API-first tạo ra những cơ hội để xác định các vấn đề chung rộng lớn và sau đó xây dựng một nền tảng để khắc phục những vấn đề đó.

Trách nhiệm của kỹ thuật là gì? 

Tâm thế API-first đã và sẽ tiếp tục dẫn Zonos đến thành công, và kỹ thuật đóng một vai trò không thể thiếu. Trách nhiệm của chúng ta là luôn duy trì tâm thế API-first. Điều này có nghĩa là chúng ta luôn đặt những câu hỏi giúp tập trung vào các API của chúng ta, chẳng hạn như: "Các API của chúng ta có thể đáp ứng nhu cầu của khách hàng như thế nào" Nó cũng có nghĩa là chúng ta luôn phản hồi các câu hỏi về tính năng và chức năng bằng cách liên kết đến tài liệu API của chúng ta. Nếu tài liệu không tồn tại, thì chúng ta tạo ra nó — làm việc cùng nhau trên các nhóm xuyên chức năng để đảm bảo rằng Zonos có tài liệu API xuất sắc.