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

Cách tiếp cận API-first là gì? 

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

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

Lợi ích của cách tiếp cận API-first 

Cách tiếp cận API-first giúp thiết lập tư duy sau:

• Chúng tôi hiểu rằng các API của chúng tôi là giao diện chính cho khách hàng, và do đó xem chúng như là các sản phẩm công khai của chúng tôi.
• Việc tài liệu trước khi viết mã cho chúng tôi cơ hội để lý luận, thảo luận, tinh chỉnh và giao tiếp các mục tiêu của chúng tôi với các nhóm và 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 tôi tập trung vào nhu cầu của khách hàng, chúng tôi hiểu cách tốt nhất để thiết kế các API đáp ứng những nhu cầu đó.

Tư duy này đặt các API và khách hàng của chúng tôi lên hàng đầu và rất quan trọng để thiết lập một nền tảng mà mọi người tại Zonos đều có trách nhiệm với 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

Cách 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ụ mà 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 cần phải chờ đợi 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 thử nghiệm mô phỏng các API và các 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à mã có thể được tái sử dụng trên nhiều dự án khác nhau. Dưới cách 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 cần 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ỳ mã nào được viết, điều này giúp ngăn ngừa 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

Nhiều quy trình xây dựng 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 tôi bắt đầu bằng cách tạo ra các loại, định nghĩa và sơ đồ cốt lõi; với những tệp đó, các công cụ API như tài liệu API, bộ công cụ phát triển phần mềm (SDK) và API mô phỏng có thể được tự động tạo ra. Tự động hóa làm tăng tốc độ phát triển của các API và ứng dụng một cách đáng kể.

Cách tiếp cận API-first cũng cho phép 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 nhanh chóng đưa các tính năng vào sản xuất để duy trì tính cạnh tranh trong thị trường SaaS xuyên biên giới đang thay đổi. Dễ dàng hơn để loại bỏ nợ kỹ thuật trong mã nền tảng hơn là di chuyển khách hàng ra khỏi một API được thiết kế kém.

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

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

Tăng cường thành công lâu dài

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

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

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) liên quan đến hệ thống hiện tại, và clear nơi mà những cải tiến lớn nhất có thể được thực hiện:

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

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

Cách tiếp cận di động đầu tiên đã dẫn đến sự gia tăng đáng kể trong tỷ lệ chuyển đổi di động rate. Kiến trúc mới cũng mang lại những cải tiến ấn tượng trong tỷ lệ chuyển đổi trên máy tính để bàn rate. Cách tiếp cận này thành công vì nó xác định cách tạo ra giá trị tối đa cho người dùng và tập trung toàn bộ cách tiếp cận vào việc cung cấp giá trị đó. Nó tạo ra tư duy đúng từ đầu. Tương tự—mặc dù có thể cảm thấy như làm ngược lại—cách tiếp cận API-first tạo ra cơ hội để xác định các vấn đề tổng thể 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ư duy API-first đã và sẽ tiếp tục dẫn dắt Zonos đến thành công, và kỹ thuật đóng một vai trò quan trọng. Chúng tôi có trách nhiệm luôn duy trì tư duy API-first. Điều này có nghĩa là chúng tôi liên tục đặt ra những câu hỏi giữ cho sự chú ý vào các API của chúng tôi, chẳng hạn như: “Làm thế nào để các API của chúng tôi đáp ứng nhu cầu của khách hàng” Nó cũng có nghĩa là chúng tôi luôn phản hồi các câu hỏi về tính năng và chức năng với một liên kết đến tài liệu API của chúng tôi. Nếu tài liệu không tồn tại, thì chúng tôi sẽ tạo ra nó—làm việc cùng nhau trong các nhóm đa chức năng để đảm bảo rằng Zonos có tài liệu API xuất sắc.